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.