What problem does it solve? Over time a project-local skill catalog drifts: skills get duplicated, descriptions stop matching their bodies, cross-references point at renamed or deleted skills, and stale entries keep getting injected into agent context. This Skill provides a repeatable audit procedure to catch that drift before the catalog becomes confusing. ## Core Features & Use Cases - Inventory and grouping: Builds a full inventory of skills (including symlinked ones), grouped by domain, with attention to recent additions via git history. - Overlap and redundancy detection: Flags duplicate descriptions, competing triggers, and stale cross-references while listing common false positives that must not be merged. - Staleness and freshness checks: Verifies that referenced code surfaces still exist, checks living-log entries for required since/holds-while markers, and validates invocation policy metadata against the active harness. - Use Case: After a week where several skills were added or renamed, run the audit to get a report of confirmed defects and merge/delete candidates with file and line references, then optionally apply safe fixes with --apply. ## Quick Start Run a skills audit over .agents/skills and report any duplicate, overlapping, stale, or broken skills with file references.
