What problem does it solve? As a project accumulates agent skills under .agents/skills/, the catalog drifts: duplicate or overlapping skills appear, descriptions stop matching their bodies, and cross-references break after renames. This Skill provides a repeatable audit procedure to catch that drift before the catalog becomes confusing. ## Core Features & Use Cases - Inventory and Census: Builds a fresh count of all SKILL.md files (including symlinked ones), grouped by domain, with git history to spot new arrivals. - Overlap and Redundancy Detection: Compares descriptions and trigger keywords within each domain to flag merge or delete candidates, while listing known false positives to avoid. - Consistency and Integrity Checks: Enforces a standard description template (Use when / Triggers on), verifies referenced skills still exist, and flags stale skills whose underlying code surface is gone. - Use Case: Run a weekly audit after several skills were added or renamed, producing a markdown report with high/medium/low-confidence recommendations and a suggested action order. ## Quick Start Run the skills-audit skill to review all SKILL.md files under .agents/skills and report duplicates, stale entries, and broken cross-references.
