# Audit Agents

Audit or rewrite AGENTS.md so it holds only lasting principles.

- Repository: https://github.com/dzhng/skills (1394 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add dzhng/skills --skill audit-agents -g -a claude-code -y`
Codex: `npx skills add dzhng/skills --skill audit-agents -g -a codex -y`
Cursor: `npx skills add dzhng/skills --skill audit-agents -g -a cursor -y`
Gemini CLI: `npx skills add dzhng/skills --skill audit-agents -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

1. Read the AGENTS.md and the root readme. This is a document audit: run no builds and no tests.
2. 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.
3. Check the shape against the example below.
4. 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.
5. 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.

## Tests for a line

The rest: https://github.com/dzhng/skills/blob/HEAD/skills/authoring/audit-agents/SKILL.md