# draft-openspec-docs

> Claude/Codex skill by [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 73k stars · Updated 2026-10-26

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.

Tags: ai, context-engineering, engineering, planning, prd, sdd, sdlc, spec, spec-driven-development, specification

## Install

```sh
git clone https://github.com/Fission-AI/OpenSpec /tmp/OpenSpec && ln -s /tmp/OpenSpec/.agents/skills/draft-openspec-docs ~/.claude/skills/draft-openspec-docs
```

## From 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.

## Links

- HTML page: https://omgskills.com/skills/fission-ai/openspec/draft-openspec-docs/
- GitHub: https://github.com/Fission-AI/OpenSpec
- Author: [@fission-ai](https://omgskills.com/library/fission-ai/index.md)

## More from this repo

- [openspec-apply-change](https://omgskills.com/skills/fission-ai/openspec/openspec-apply-change/index.md) — Implement tasks from an OpenSpec change.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars
- [openspec-archive-change](https://omgskills.com/skills/fission-ai/openspec/openspec-archive-change/index.md) — Archive a completed OpenSpec change in the experimental workflow.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars
- [openspec-bulk-archive-change](https://omgskills.com/skills/fission-ai/openspec/openspec-bulk-archive-change/index.md) — Archive multiple completed OpenSpec changes at once.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars