docs-checklisted
Install: claude install-skill brandtam/skills
# Docs Check
Diff-driven documentation maintenance. Given the work on the current branch,
decide whether existing docs went stale or new docs are needed, and propose
the specific changes.
## First Checks
1. Read repo instructions (`AGENTS.md`, `CLAUDE.md`) and any docs conventions
they link — folder contract, authoring guide, audience definitions.
2. Locate the docs root. Default `docs/`; honor whatever the repo's
conventions declare, including audience subfolders (e.g. `docs/editors/`
for end-user pages, `docs/dev/` for developer/admin pages).
3. Get the diff: `git diff <default-branch>...HEAD` plus untracked files.
If there is no diff, say so and stop.
## Classify the change
For each logical change in the diff, decide who can observe it:
- **End users / operators** — UI, workflows, settings, content-editor
behavior → end-user docs folder.
- **Developers / admins** — setup, config, env vars, commands, APIs,
deployment, schema → developer docs folder.
- **Nobody** — refactors, tests, internal cleanups → no doc change; say so
explicitly rather than inventing one.
## Find stale pages
Search the docs folders for statements the diff invalidates: renamed
commands or flags, changed defaults, removed settings, altered workflows,
outdated screenshots or examples. Grep for identifiers that the diff touched
(setting keys, command names, route paths, env var names).
## Propose, then apply
Present a short plan before editing:
- pages to **edit**, each with th