What problem does it solve?
Agent guidance files like AGENTS.md and CLAUDE.md tend to accumulate duplicated instructions, drift out of sync with executable sources, and bloat context budgets. This Skill keeps repository agent documentation as a lean routing and correction layer instead of a second documentation system.
Core Features & Use Cases
- Placement Rules: Directs durable facts to the nearest AGENTS.md, keeps CLAUDE.md as an @AGENTS.md alias, and routes repeatable workflows into skills under .agents/skills/.
- Drift and Duplication Cleanup: Searches existing agent docs for overlap or contradiction, prefers updating source pointers and validators over copying content, and removes obsolete guidance in the same change.
- Validation Workflow: Runs pnpm check:workspace and reviews reported context budgets after changes.
- Use Case: When setup instructions are duplicated across AGENTS.md, CLAUDE.md, and a skill, use this Skill to consolidate them into pointers to executable sources with passing validators.
Quick Start
Use the maintain-agent-docs skill to remove duplicated setup instructions from the agent guidance files and verify the context budget report.
