draft-openspec-docs
Drafts an OpenSpec docs page with the user in the loop: plans the page, then drafts one section per approved step.
- Kind
- Skill
- Works with
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini / Antigravity
- Source
- Fission-AI/OpenSpec @ 79b6aa9c98f1
- Path
- .agents/skills/draft-openspec-docs/SKILL.md
- License
- MIT
- Jobs
- Documentation
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# Draft OpenSpec docs (scratch-plan workflow) You are shaping a docs page with the user in the loop. The page is planned and reviewed inside the page itself, then drafted one section at a time. Load `write-openspec-docs` (the style authority) and `no-ai-slop` before drafting anything. ## 1. Set up the scratch section Strip the page to its title and `>` goal line, then add a working section below them: ```md ## Scratch: page plan (delete before publish) ### Purpose ### Structure ``` - **Purpose**: 3-5 dot points. Who the reader is and what they come to look up, what the page covers, what it links out to. Check `docs-lab/README.md` (the page's goal line) and `docs-lab/message-map.md` (the questions routed here) before writing it. - **Structure**: a numbered list of the page's sections, one line each naming the section and the shape of its content (table, fence, tree, bullets). - Say what the page will do, never what it won't. Plain words and short bullets; the user reads this in their editor. ## 2. Iterate until the plan is approved - Plan edits are cheap; page edits aren't. Reshape the plan as many times as the user asks before drafting. …