document-it
Installation
SKILL.md
Document It
Make the next human (or agent) able to use, operate, or change the thing without reverse-engineering — without overbuilding docs.
Goldilocks first
| Situation | Do |
|---|---|
| You just fixed/shipped/refactored something | Surgical update — nearest accurate README, runbook, API note, changelog, or existing docs/ section. Stop when a skeptic can use the change. |
| Product promise, requirements, test/obs contracts, or irreversible decisions | DocSlime altitude — update (or carefully add) the matching DocSlime page / ADR using DocSlime methods |
No docs/ and you only need a local how-to |
Write/update root README or a small existing doc — don’t docslime init for a paragraph |
| User asks to set up / fill product docs | Then use docslime-init / docslime-fill / etc. |
Don’t overuse DocSlime. Init, full-tree fill, or new template pages are earned by missing product-altitude truth — not by “we should document this PR.”