claude-md-auditlisted
Install: claude install-skill HCvCH/claude-auto-kit
# CLAUDE.md audit
Every line in a CLAUDE.md is loaded into every session. Stale, duplicated or contradictory instructions cost tokens and make newer models follow the wrong rule. This skill finds those lines and proposes a shorter file. It never rewrites the file without the user's go-ahead.
## 1. Collect
Read every instruction file that loads into a session:
- the global file (`~/.claude/CLAUDE.md`, on Windows `C:\Users\<user>\.claude\CLAUDE.md`)
- the project file (`./CLAUDE.md`, `./.claude/CLAUDE.md`) and any files they import with `@path`
- rules that live elsewhere and overlap: skill descriptions the user relies on, `settings.json` permissions
Report the size of each file in lines and an estimate in tokens (about 4 characters per token).
## 2. Classify every instruction
Put each instruction into exactly one bucket:
| Bucket | Meaning | Action |
|---|---|---|
| Keep | Specific, still true, changes behaviour | keep, tighten wording |
| Stale | Refers to tools, paths, models, versions or workflows that no longer exist | remove |
| Duplicate | Says the same as another line, a skill, or the model's default behaviour | remove or merge |
| Conflict | Contradicts another line or a newer instruction | ask which one wins |
| Vague | "Write clean code", "be careful" — no testable behaviour | make specific or remove |
| Belongs elsewhere | Long how-to or reference material | move into a skill or a separate file loaded on demand |
| Workaround | Compensates for an old model's