What problem does it solve? Agent entry files like AGENTS.md and CLAUDE.md tend to bloat over time, accumulating oversized sections, broken links, and orphaned context files that consume maintenance effort without ever being loaded. This Skill audits those files and the context/ directory they reference, producing a report of token waste and progressive-disclosure violations. ## Core Features & Use Cases - Entry file auditing: Measures AGENTS.md and CLAUDE.md against a 4000-character budget and flags any ## section over 600 characters as an extraction candidate for context/. - Orphan and broken-link detection: Identifies context/*.md files not linked from any entry file, and entry-file links pointing at nonexistent files. - Near-duplicate detection: Compares context files pairwise with a similarity ratio of 0.80 to flag merge candidates. - Use Case: After months of editing AGENTS.md, run the audit to discover that a 70,000-character roadmap.md is orphaned and that two standards files are near-duplicates, then apply the suggested fixes. ## Quick Start Ask the agent to audit this repository's AGENTS.md and context directory for token waste and orphaned files.
