docslisted

Manage project documentation - internal ./docs (init, update, check, ADR) and, via the site subcommand, the rendered public docs website (Astro Starlight): create, modernize, validate, and ship it. Canonical internal set stays small: development guidelines, system architecture, tech stack, deployment, plus append-only ADRs. Also owns illustrated how-tos (HTML, PDF, Markdown) that point at a UI with screenshots. Use when the user asks to update docs, record an ADR, build a docs website, add Starlight, reproduce the shared centered docs style, fix responsive docs layout, migrate a docs site, verify and deploy developer documentation, or annotate screenshots in a how-to. Scouts the codebase and delegates writing to the docs-manager subagent (or stays inline with --inline).
vanducng/skills · ★ 8 · Web & Frontend · score 81

Install: claude install-skill vanducng/skills

# Docs Keep `./docs/` honest. Scout the code, diff it against what the docs claim, write what's true. Small canonical set - easy to keep current, hard to let rot. ## Two surfaces, one skill `./docs/` is **team-facing** truth - journals are personal (injected `Journals:` path), plans and reports live at the injected `Plans:` / `Reports:` paths, never in `./docs/`. `init`/`update`/`check`/`adr` own internal Markdown; `site` owns the rendered public website (formerly the separate tech-docs skill). Internal-content hard rules 1-5 below apply to the Markdown surface; the site surface carries its own rules in `references/site-workflow.md`. Rules 6-7 (unslop + prose standard) apply to both. ## Subcommands | Subcommand | Reference | When | |---|---|---| | `init` | `references/init-workflow.md` | Fresh repo - no `./docs/` yet, or only a stub README | | `update` | `references/update-workflow.md` | Code drifted from docs after a feature, refactor, or migration | | `check` | `references/check-workflow.md` | Validate-only: required files, size, freshness, broken refs. No writes. | | `adr` | `references/adr-workflow.md` | Record an architecture decision (the *why* behind an irreversible choice) under `docs/decisions/` | | `site` | `references/site-workflow.md` | The rendered public docs website (Astro Starlight): create, modernize, validate, ship. Owns `assets/theme.css` (centered profile) and `references/site-blueprint.md` | Parse `$ARGUMENTS` first word (runtimes without `$ARGUMENT