doclisted

Assess documentation for gaps, staleness, quality, and files outside the defined doc set. Preserve useful knowledge in canonical docs, then remove superseded or unnecessary files. Check changed code when the tree is dirty, otherwise assess the whole repo. Explicit modes: --review, --update, --generate, or --session to capture durable knowledge from a conversation or transcript. Use for doc creation, cleanup, freshness, quality, or saving occasional manual test procedures and results whose numbers a later run will compare against; routine suite runs and ordinary QA passes do not need test records.
nielsmadan/skills · ★ 1 · Data & Documents · score 77

Install: claude install-skill nielsmadan/skills

# Doc Assess, review, update, generate, and prune documentation following consistent principles. ## Reference files (load what the run needs) | File | Load when | |------|-----------| | `references/principles.md` | Writing, sizing, or judging docs — the 8 principles and the Minimal/Lean/Structured profiles. Assess needs it to pick a profile; review/update/generate to apply it. | | `references/cleanup.md` | Assessing which docs belong, or applying a cleanup: extract useful knowledge, repair links, then remove the superseded files. | | `references/mode-review.md` | `--review` | | `references/mode-update.md` | `--update` | | `references/mode-generate.md` | `--generate` | | `references/mode-session.md` | `--session` | | `references/manual-tests.md` | Capturing occasional manual tests, or generating/updating/reviewing `docs/tests/` | | `references/generate-templates.md` | Writing a new doc from scratch | Routing (below) does not need any of them. ## Which mode runs (read first) **Bare `/doc` = context-aware assess.** It adapts its *scope* to git state but always runs all four lanes (Generate / Update / Review / Cleanup) and never writes without a plan, it proposes, then runs your picks. - **Dirty tree (staged or unstaged changes) → "is what I just did documented?"** Center the assess on the changed files: are the docs covering them still accurate (**Update** lane), and do