Generate or remediate documentation with human-quality writing and style adherence. Triggers: documentation, generate docs, write docs, technical writing, generate documentation, write readme, create guide, doc generation, remediate docs, polish content, clean up docs. Use when creating new documentation, rewriting AI-generated content, or applying style profiles. Do not use for slop detection only (use slop-detector) or learning styles (use style-learner).
View on GitHubplugins/scribe/skills/doc-generator/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/athola/claude-night-market/blob/main/plugins/scribe/skills/doc-generator/SKILL.md -a claude-code --skill doc-generatorInstallation paths:
.claude/skills/doc-generator/# Documentation Generator Documentation must be grounded in specific claims rather than abstract adjectives. We avoid filler phrases like "In today's fast-paced world" and focus on delivering useful information directly. Each claim should be supported by evidence, such as specific version numbers or request rates, rather than vague descriptors like "comprehensive." ## Core Writing Principles We prioritize authorial perspective and active voice to maintain a consistent team tone. This involves explaining the reasoning behind technical choices, such as selecting one database over another, rather than providing neutral boilerplate. Bullets should be used sparingly for actionable summaries; multi-line bullet waterfalls should be converted to short paragraphs to preserve nuance. ### Vocabulary and Style Avoid business jargon and linguistic tics like mirrored sentence structures or excessive em dashes. We use the imperative mood for docstrings (e.g., "Validate input") and strictly avoid humanizing non-living constructs like code. | Instead of | Use | |------------|-----| | fallback | default, secondary | | leverage | use | | utilize | use | | facilitate | help, enable | | comprehensive | thorough, complete | ### 9. Limit Humanizing Constructs "Lives under," "speaks to," and similar phrases only make sense for living things. ### 10. Imperative Mood for Docstrings "Validate" not "Validates" (per PEP 257, pydocstyle, ruff). ## Required TodoWrite Items 1. `doc-generator:scope-defined` - Target files and type identified 2. `doc-generator:style-loaded` - Style profile applied (if available) 3. `doc-generator:content-drafted` - Initial content created 4. `doc-generator:slop-scanned` - AI markers checked 5. `doc-generator:quality-verified` - Principles checklist passed 6. `doc-generator:user-approved` - Final approval received ## Mode: Generation For new documentation: ### Step 1: Define Scope ```markdown ## Generation Request **Type**: [README/Guide/API docs/Tut