Updated 1d ago
by microsoft
ShadowFrog
A suite of AI coding agent skills that build and maintain a shadow knowledge base for any codebase.
28 GitHub stars (28)
Steady at 28 stars — no new stars in the 16 days since Sep 30.
- 7 skills (7 skills found in its SKILL.md files)
- 9 forks (9 forks)
- 1d ago last update (Last updated 1d ago)
Install
Skills CLI
npx skills add microsoft/ShadowFrog
Asks which skills and agents to install. Just one: npx skills add microsoft/ShadowFrog --skill shadow-frog-dream — add -g for every project.
Claude Code
git clone https://github.com/microsoft/ShadowFrogcp -r "ShadowFrog/skills/shadow-frog-dream" ~/.claude/skills/
Copies the shadow-frog-dream skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add microsoft/ShadowFrog
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
shadow-frog-dream
Run autonomous experimentation while the user is AFK. Uses 6 investigation categories (investigation, bug hunting, feature design, refactoring, optimization, security audit) to systematically discover non-obvious behaviors. Every task is an experiment — implement in worktrees, commit to persistent dream branches, and push to the configured remote. Dreams compound across sessions: future experimen…
skills/shadow-frog-dream/SKILL.md on GitHub (opens in a new tab) -
shadow-frog-init
Initialize a shadow knowledge base for any codebase. Creates a .shadow/ directory that mirrors the source tree with markdown files for AI-discovered insights. Run this once per repo before using other shadow-frog skills. Refuses to overwrite an existing .shadow/ unless --reset is passed.
skills/shadow-frog-init/SKILL.md on GitHub (opens in a new tab) -
shadow-frog-meditate
Clean and consolidate the shadow knowledge base. Scans all shadow files for duplicate discoveries (same claim, different wording), near-duplicates (one extends another), and conflicting entries (contradicting claims). Merges duplicates, resolves conflicts by investigating the code, and asks the user only when resolution is unclear. Invoke periodically to keep the shadow focused and free of noise.
skills/shadow-frog-meditate/SKILL.md on GitHub (opens in a new tab) -
shadow-frog-nap
Generate grounded software feature-task briefs with a small, bounded ideation budget instead of implementing every idea. Read focused source and optional shadow/dream evidence, grow or resume a persistent proposal tree, and obtain independent shortlist judgments. Run only decision-changing probes of existing behavior. Use mode=coherent to connect each child to its parent's findings or design whil…
skills/shadow-frog-nap/SKILL.md on GitHub (opens in a new tab) -
shadow-frog-update
Update the shadow knowledge base after code changes and from conversational insights. Detects what changed via git diff, refreshes per-file shadows, captures knowledge shared by the user during the session, and updates cross-cutting discoveries. Invoke manually with /shadow-frog-update; the preToolUse hook will remind the agent when the shadow is behind HEAD.
skills/shadow-frog-update/SKILL.md on GitHub (opens in a new tab) -
shadow-frog-viewer
Help users browse and visualize the shadow knowledge base: overview, search for files or symbols or text, view preferences, or see recent discoveries. Invoke when the user wants to see what's in the shadow, get an overview, or find specific knowledge.
skills/shadow-frog-viewer/SKILL.md on GitHub (opens in a new tab) -
shadow-frog
Use a shadow knowledge base to understand any codebase. The .shadow/ directory mirrors the source tree with markdown files containing behavioral insights — known bugs, edge cases, implicit contracts, and user preferences. Always check the shadow before editing, debugging, or investigating code. When the user shares important context, write it to the shadow immediately. Invoke shadow-frog-init to…
skills/shadow-frog/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.