# write-openspec-docs

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

Switches into OpenSpec docs-writing mode; loads the house style guide and drafts or revises pages in its voice (action-first, no preamble, scannable). Use when writing or editing pages in the OpenSpec docs tree.

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/write-openspec-docs ~/.claude/skills/write-openspec-docs
```

## From README

Write OpenSpec docs You are now writing OpenSpec's user docs. Read writing.md; it is the style authority for everything drafted here. The short version, in effect immediately: A page is a retrieval surface, not an essay. Structure decides whether the reader finds the answer; prose only decides how it reads. Open every section with the answer, never a running story. Choose the page type before the outline. Guides follow the reader's task; reference mirrors the product's structure and uses exact field, command, and file names as scan anchors. Reference needs complete coverage without compressing several facts into one sentence, cell, or paragraph. Draft the shortest version that answers; expanding a spare page is cheap, cutting a bloated one is a rewrite. Plain words, the fewest of them: an idea that fits in one line takes one line. Depth most readers skip goes behind a link, and the payload (commands, real output, failures and fixes) stays whole. Dumb sentences, smart structure.

## Links

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

## More from this repo

- [draft-openspec-docs](https://omgskills.com/skills/fission-ai/openspec/draft-openspec-docs/index.md) — Collaborative page-drafting mode for the OpenSpec docs.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 73k stars
- [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