← ClaudeAtlas

atomic-documentationlisted

Diff-driven documentation surface classifier. Given a diff (staged, branch, or range), reads the project's indexed ## Documentation surfaces table from CLAUDE instructions, matches the diff against it, and emits a structured list of proposed edits. Two modes: maintenance (commit flow — stale/incomplete only, never suggests new pages) and authoring (/documentation explicit — full discovery, gap detection, content generation). Auto-fires on "doc this change", "what surfaces does this touch", "doc impact for this diff", "what needs documenting". Also invoked by /documentation (authoring mode) and by ship verbs (maintenance mode, between stage and signals). Boundary: for raw prose drafting (README intro, guide narrative), atomic-prose owns. This skill owns diff-driven surface impact and content generation for stale/incomplete docs.
damusix/atomic-claude · ★ 37 · Code & Development · score 80
Install: claude install-skill damusix/atomic-claude
<trigger> Auto-fires on: "doc this change", "what surfaces does this touch", "doc impact for this diff", "what needs documenting". Also invoked by `/documentation` (authoring mode) and by ship verbs (maintenance mode, between stage and signals). </trigger> This skill reads the project's indexed documentation surfaces, matches a diff against them, and either flags stale/incomplete docs (maintenance mode) or runs the full discovery + generation pipeline (authoring mode). It emits a structured YAML block listing affected surfaces. When the user picks "Yes", it opens the file and makes the edit. ## Two voices | Voice | Where | Style | |-------|-------|-------| | **How Claude talks** | TUI replies | Atomic output style: terse, fragments OK, drop articles. Governed by `output-styles/atomic.md`. | | **How files are written** | All file content | Narrative docs (`README.md`, `docs/guides/`) use `atomic-prose` skill. Everything else (specs, designs, `CLAUDE.md`, signals, agents, commands) uses terse technical prose: tables, bullets, imperative. | ## How surface routing works The skill reads the `## Documentation surfaces` table from the project's CLAUDE instructions. Search order: `claude.local.md` or `CLAUDE.local.md` (treated as a pair) → `CLAUDE.md`. First file containing the heading wins. Expected table format: ```markdown ## Documentation surfaces | Path | Covers | Voice | |------|--------|-------| | `docs/architecture/payments.md` | billing, webhooks, Stripe | atomic-