shadow-frog-init

Initialize a shadow knowledge base mirroring source trees with markdown files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the initialization of a shadow knowledge base for codebases, creating a mirror of the source tree with markdown files containing AI-discovered insights.

Core Features & Use Cases

  • Shadow Knowledge Base Initialization: Automatically creates a .shadow/ directory with markdown files that mirror the source tree.
  • File and Symbol Discovery: Discovers source files and extracts symbols from each file.
  • Shadow File Creation: Generates per-file shadow .md files with symbol headings and cross-references.
  • Version Control Integration: Integrates with version control systems to handle .shadow/ directory management.

Quick Start

Run the 'shadow-frog-init' command within your codebase to initialize the shadow knowledge base.

Frequently Asked Questions about shadow-frog-init

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

FAQPage Schema
How do I generate a shadow knowledge base for my codebase?

To generate a shadow knowledge base, initialize a mirrored markdown structure by running an automated initialization command that discovers source files and extracts symbols into a `.shadow/` directory.

What is a shadow knowledge base and how does it work with source files?

A shadow knowledge base works by mirroring your source tree with markdown files, containing AI-discovered insights and symbol headings extracted directly from your source files.

Does the shadow knowledge base extraction process support multiple programming languages?

Yes, the symbol extraction process handles file discovery and symbol extraction for a variety of programming languages, creating per-file shadow markdown files with cross-references.

Do I need a version control system to initialize shadow markdown files?

Yes, you need a version control system and access to the source code, as the initialization process integrates with version control to manage the `.shadow/` directory.

What's the best way to automate codebase symbol extraction for future analysis?

The best way to automate symbol extraction is to initialize a shadow knowledge base, which automatically discovers source files and generates comprehensive markdown files with symbol headings.

How does the shadow directory handle version control integration?

The shadow directory handles version control integration by automatically creating a `.shadow/` folder that mirrors the source tree, ensuring the generated markdown files are managed alongside your codebase.