Description
draft-openspec-docs is an agent skill from the OpenSpec project for drafting a documentation page together with a person. Instead of writing the whole page at once, it plans the page inside the page itself. It sets up a scratch section that holds a purpose list of three to five points, covering who the reader is, what they will look up and what the page links to, and a numbered structure of the sections with the shape of each one, such as a table, a code fence, a tree or bullets. The plan is reviewed in the editor, and the page is then drafted one section at a time, with the user in the loop at each stage. Before it drafts anything, the skill loads the write-openspec-docs style guide and the no-ai-slop writing guidance, and it checks the page's goal and the questions routed to it in the docs lab files. The skill says to state what the page will do rather than what it will not, and to use plain words and short bullets. It is for writers and maintainers of OpenSpec's documentation who want a careful, reviewed draft rather than a generated page. The skill passes Gen Agent Trust Hub and Socket on skills.sh, and Snyk shows a warning. It has about 2,300 installs. Install it with npx skills add https://github.com/fission-ai/openspec --skill draft-openspec-docs.…
Highlights
- Plans the docs page inside the page before drafting
- Purpose list and numbered structure for review
- Drafts one section at a time with the user in the loop
- Loads the OpenSpec docs style guide before writing
Ratings & Reviews
No ratings yet
Be the first to rate draft-openspec-docs.
People also visit
verify-openspec-docs
Fact-checks OpenSpec user documentation with a fresh-context subagent
understand-onboard
Generate an onboarding guide for new team members joining a project
code-documentation
The user requests to generate, create, or improve documentation for code, APIs
draft-openspec-docs FAQ
How does the drafting work?
It creates a scratch plan with a purpose list and a structure inside the page, then drafts one section at a time after review.
What does the scratch plan contain?
A purpose list of three to five points and a numbered structure that describes each section's content.
Which guides does it load first?
The write-openspec-docs style guide and the no-ai-slop writing guidance, before drafting.
How do I install it?
Run npx skills add https://github.com/fission-ai/openspec --skill draft-openspec-docs.
Which security audits does it have?
On skills.sh, Gen Agent Trust Hub and Socket pass, and Snyk shows a warning.
What are the best draft-openspec-docs alternatives?
Popular alternatives to draft-openspec-docs include verify-openspec-docs, write-openspec-docs and understand-domain. See all draft-openspec-docs alternatives