draft-openspec-docs
Collaborative page-drafting mode for the OpenSpec docs. Builds a scratch plan inside the target page (purpose, structure, numbered draft steps), iterates on it with the user, then drafts one section per approved step and cleans up after itself. Use when a page needs a from-scratch rewrite or a new page is being shaped with the user in the loop.
Install
With your agent
Install OMGSkills skill "fission-ai/openspec:draft-openspec-docs" into this agent's normal skills directory: use the OMGSkills MCP get_skill tool, install only the pinned_install commit and path, verify SKILL.md against pinned_install.skill_md_sha, and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/Fission-AI/OpenSpec /tmp/OpenSpec && ln -s /tmp/OpenSpec/.agents/skills/draft-openspec-docs ~/.claude/skills/draft-openspec-docsFrom README
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. Set up the scratch section Strip the page to its title and > goal line, then add a working section below them: 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. Iterate until the plan is approved Plan edits are cheap; page edits aren't.