shadow-frog-meditate Skill

Source

• Creator: microsoft
• Repository: microsoft/ShadowFrog
• Skill file: skills/shadow-frog-meditate/SKILL.md

What it does

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 resolutio

Skill instructions

ShadowFrog Meditate Shadow hygiene — deduplicate, merge, and resolve conflicts across the entire .shadow/ knowledge base. Prerequisite: .shadow/ exists with discoveries. Why Meditate? Over time, shadows accumulate noise: - Duplicates: the same insight written differently by different sessions - Near-duplicates: one discovery is a subset of another - Conflicts: two discoveries contradict each other (code may have changed, or one was wrong) - Cross-scope duplicates: a per-file discovery and a cross/ entry saying the same thing This noise confuses downstream agents and dilutes signal. Meditate cleans it up. Phase 1: Scan Use parallel subagents to scan the shadow. Each subagent handles a batch of shadow files. Scope Optimization Not every file needs scanning. To reduce cost: - Skip files with 0-1 discoveries — they can't have internal duplicates - Focus on files modified since last meditate — check meta/state.json lastupdateat against file modification times - Always scan files with 5+ dis