shadow-frog-update

Update a shadow knowledge base with code changes and session insights.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your shadow knowledge base remains current with the latest code changes and insights from your conversations, enabling your AI agent to make more informed decisions.

Core Features & Use Cases

  • Code Change Detection: Automatically detects code changes using git diff.
  • Per-File Shadow Updates: Refreshes per-file shadows with updated information.
  • Conversational Knowledge Capture: Captures and stores knowledge shared during sessions.
  • Session Insights Extraction: Reviews sessions for unrecorded knowledge and cross-cutting discoveries.
  • Structural Change Handling: Manages added, deleted, and renamed files in the shadow.
  • Verification and Deduplication: Ensures discovery integrity and removes duplicates.
  • Reference Integrity Check: Verifies the consistency of cross-references and other structural elements.
  • Metadata Update: Refreshes the metadata with the latest state information.
  • Discovery Writing Rules: Provides guidelines for writing and formatting new discoveries.
  • Staleness Rules: Defines rules for handling outdated knowledge.
  • **Quick Start Run the /shadow-frog-update command to update the shadow knowledge base.

Frequently Asked Questions about shadow-frog-update

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

FAQPage Schema
How do I keep my codebase shadow knowledge base up-to-date with recent code changes?

To keep your shadow knowledge base up-to-date, this Skill detects code changes using git diff, refreshes per-file shadows, and verifies reference integrity automatically. It ensures your AI agent has the latest structural and conversational insights.

What is a shadow knowledge base and how does it capture conversational insights?

A shadow knowledge base stores markdown files containing session insights and conversational knowledge. This Skill extracts unrecorded knowledge from your development sessions and cross-cutting discoveries to inform your AI agent.

Do I need git to update shadow knowledge with code changes?

Yes, you need git for change detection to update shadow knowledge accurately. The Skill relies on git diff to identify structural changes like added, deleted, or renamed files and refreshes metadata accordingly.

How do I verify reference integrity and deduplicate discoveries in a shadow knowledge base?

To verify reference integrity and deduplicate discoveries, the Skill checks cross-references and structural elements while removing duplicates. It applies staleness rules and discovery writing guidelines to maintain knowledge accuracy.

What's the best way to handle structural changes like renamed files in a shadow knowledge base?

The best way to handle structural changes is running the Skill's update command, which manages added, deleted, and renamed files in the shadow. It refreshes metadata and ensures cross-references remain consistent.