review-agents-md
Creates minimal, effective AGENTS.md files using progressive disclosure. Triggers on "create agents.md", "refactor agents.md", "review my agents.md", "claude.md", or questions about agent configuration files. Also triggers proactively when a project is missing AGENTS.md.
npx skills add majiayu000/claude-skill-registry --skill review-agents-md --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AGENTS.md Skill ## Overview Creates and refactors AGENTS.md files following progressive disclosure principles. Keeps files minimal and focused—avoiding the "ball of mud" that hurts agent performance. ## When to Use - **Proactively** when a project has no `AGENTS.md` at the root — check for this when starting work in a new project - Creating a new AGENTS.md from scratch - Refactoring a bloated AGENTS.md - Reviewing an existing file for best practices - Setting up AGENTS.md for a monorepo - When `AGENTS.md` exists but `CLAUDE.md` is missing (should be symlinked) ## Core Principles 1. **Minimal by default**: Only include what's relevant to every single task 2. **Progressive disclosure**: Point to separate files, external docs, or agent skills for domain-specific rules 3. **Never document file structure**: It goes stale fast and poisons agent context 4. **Describe capabilities, not locations**: "Auth uses JWT" not "Auth is in src/auth/" ### The Instruction Budget Frontier LLMs can follow ~150-200 instructions with reasonable consistency. Every token in AGENTS.md loads on **every request**, regardless of relevance. The ideal file should be as small as possible. ### Why Files Get Bloat
- Overview
- When to Use
- Core Principles
- The Instruction Budget
- Why Files Get Bloated
- Stale Docs Poison Context
- Process
- Phase 0: Detect Missing Files
- Phase 1: Assess Current State
- Phase 2: Apply the Essential Test
- Phase 3: Identify Anti-Patterns
- Phase 4: Create Progressive Disclosure Structure
- Phase 5: Handle Monorepos
- Phase 6: Output
ln -s AGENTS.md CLAUDE.md
What does the review-agents-md skill do?
Creates minimal, effective AGENTS.md files using progressive disclosure. Triggers on "create agents.md", "refactor agents.md", "review my agents.md", "claude.md", or questions about agent configuration files. Also triggers proactively when a project is missing AGENTS.md.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill review-agents-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.