shadow-frog-viewer

Browse and query a codebase's shadow knowledge base with Python.

18|4|Updated May 19, 2026
One-click install
npx skills add https://github.com/microsoft/ShadowFrog --skill shadow-frog-viewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadow-frog-viewer
Source: https://github.com/microsoft/ShadowFrog/tree/main/skills/shadow-frog-viewer
Command: npx skills add https://github.com/microsoft/ShadowFrog --skill shadow-frog-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

This Skill allows users to browse and query the shadow knowledge base, providing insights into the discovered behaviors and interactions within a codebase.

Core Features & Use Cases

  • Overview: Quickly get a summary of the shadow knowledge base, including counts, source/status/label breakdown, per-file table, and cross-cutting titles.
  • Search: Search for files, symbols, or text within the shadow knowledge base.
  • Preferences: View project-wide preferences.
  • Recent Discoveries: See the most recent discoveries with full content.
  • Top Discoveries: View the top actionable discoveries for a specific file.
  • Structural Audit: Check the structural integrity of the shadow knowledge base.

Quick Start

Run the command python3 .github/skills/shadow-frog-viewer/shadow-viewer.py --summary to get an overview of the shadow knowledge base.

Frequently Asked Questions about shadow-frog-viewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I browse a shadow knowledge base to understand codebase interactions?

To browse a shadow knowledge base, use this Skill to interactively query discovered behaviors and interactions within a codebase. It provides an overview of counts, statuses, labels, and cross-cutting titles for quick insights.

How do I search for specific files or symbols within a shadow knowledge base?

You can search for files, symbols, or text within a shadow knowledge base using the search functionality. This allows you to locate specific code understanding details and retrieve relevant knowledge base entries.

How can I view recent and top actionable discoveries for a specific code file?

View recent discoveries with full content or retrieve top actionable discoveries for a specific file. This Skill queries the shadow knowledge base to surface the most relevant codebase analysis findings.

Do I need Python to query the shadow knowledge base of a codebase?

Yes, you need Python installed to run the scripts that query the shadow knowledge base. You also need access to the shadow knowledge base directory to perform structural integrity checks and retrieve project-wide preferences.

What is the best way to check the structural integrity of a shadow knowledge base?

The best way to check structural integrity is using the built-in audit feature. This Skill performs a structural integrity check on the shadow knowledge base directory to ensure consistent codebase analysis data.