← ClaudeAtlas

generate-docslisted

Generate incremental, diff-driven developer guides through the project's detected docs adapter. Never regenerate the whole site, scaffold it, or edit source. Triggers: "generate-docs", "generate the docs", "document this unit".
gtrabanco/agentic-workflow · ★ 21 · AI & Automation · score 80
Install: claude install-skill gtrabanco/agentic-workflow
# Generate Docs Turn the knowledge produced by a unit of work into developer documentation a contributor can read on the project's docs website — incrementally, as a by-product of shipping, so a public repo's docs stay current instead of rotting. A commit says what changed; a guide says how to use it ("how do I create a domain event and where do I register its handler"). ## Turn contract — verify before ending the turn ``` ✓ The docs adapter was resolved through the Step 0 detection checklist and the outcome (adapter name, or NOT CONFIGURED) is stated in the report ✓ Every generated/updated page is WRITTEN to disk (paths listed in the report) and carries the provenance frontmatter — or zero pages were written and the report says exactly why ✓ The verify step was RUN (docs build command or link check) and its result pasted — never assumed ✓ Artifact language: explicit user instruction > the project's declared docs language > English. The CONVERSATION language never decides ✓ The fixed report block is printed, then the closing `→ Next:` block, as the ABSOLUTE last output ``` About to end the turn with any box unchecked? The turn is NOT done — complete the missing box first (weak models drop end-of-document duties; this list is first on purpose). ## When to use - **After finishing a unit of work** — `execute-phase` recommends this skill at close-out when the project declares a docs site: document what the unit changed while the context is fresh. - **On dema