Audit Agents
Audit or rewrite AGENTS.md so it holds only lasting principles.
Install
npx skills add dzhng/skills --skill audit-agents -g -a claude-code -y- Repository
- dzhng/skills1.4k
- Category
- AI and agents
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 794 tokens
- Runs scripts
- No, instructions only
What it does
Audit or rewrite AGENTS.md so it holds only lasting principles. Run it only when the user asks for it by name; never invoke it on your own.
Audit Agents
AGENTS.md is read by everyone who will ever work on the project. Picture the next thousand contributors over the next hundred years: a line belongs only if it is still true, and still changes what they do, after every file, tool and dependency has been replaced.
Workflow
- Read the AGENTS.md and the root readme. This is a document audit: run no builds and no tests.
- Give every line one verdict, using the tests below.
- Keep: a principle that passes every test.
- Rephrase: a lasting lesson worded in today's mechanics, or too vague to act on.
- Move: a detail someone needs. Name the owner it belongs to: a readme, a manifest, a skill or a spec.
- Delete: repetition, history, or a line that changes nothing.
- Check the shape against the example below.
- Report the findings, highest impact first. Quote each line, give its verdict and the replacement text, and group repeats. Report no finding you can't quote.
- Edit only when the user asks for a rewrite. Then start from the example, write the file, and reread it as a newcomer with no history of this session.
