update-agents-md
Installation
SKILL.md
What I do
- Analyze existing AGENTS.md files or create new ones from scratch
- Apply progressive disclosure principles to maximize context efficiency
- Create hierarchical documentation structures (root + domain-specific docs)
- Ensure AGENTS.md follows best practices: minimal, focused, and future-proof
Core Philosophy
The ideal AGENTS.md is as small as possible. Every token loads on every single request, regardless of relevance. Frontier LLMs can follow ~150-200 instructions consistently—don't waste this budget on irrelevant guidance.
The Instruction Budget
- Small, focused AGENTS.md = more tokens for task-specific work
- Large, bloated AGENTS.md = fewer tokens for actual work + agent confusion
- Irrelevant instructions = token waste + distraction = worse performance
Progressive Disclosure
Give agents only what they need right now. Point to other resources when needed. Agents are fast at navigating documentation hierarchies.