# Better Docs

> Optimize repository documentation and make AGENTS.md a lean routing file. Use this skill whenever: the user wants to clean up project docs, reorganize documentation, audit AGENTS.md, reduce AGENTS.md bloat, move detailed content into docs/, create a docs/ structure, harvest decisions from old plans, write ADRs from implemented features, deduplicate documentation, remove stale docs, or any request involving "clean up docs", "optimize AGENTS.md", "docs audit", "documentation maintenance", "organize my docs", "lean AGENTS.md", "better docs", "doc inventory", "docs restructure". Also trigger when the user says things like "my AGENTS.md is too long", "docs are a mess", "where should this doc go", or "make AGENTS.md smaller".

## Facts
- Page: https://tashan.sh/capability/skill-darmikon-better-docs
- tashan id: skill:Darmikon/better-docs
- Source: https://github.com/Darmikon/skills
- Type: skill
- Category: devtools
- tashan score: not scored (catalogued only — too little public evidence)
- Adoption: 9.0
- Upkeep: not measured
- Freshness: not measured
- Evidence coverage: not measured
- Health: not measured
- Instruction depth: not yet graded
- Official: no

## Install

```sh
cp -r better-docs ~/.claude/skills/
```

## Security audit
Not scanned. We audit npm-published capabilities; this one has no npm package we can resolve, or has not reached the queue. This is not a clean bill of health.

---
Measured 2026-08-05 by tashan (https://tashan.sh) from public evidence. Scorer s5.