About docs-writer
A document-writing skill that selects instructions for PRDs, design docs, ADRs, audits, and feature archiving. It updates existing documents or guides discovery when a document is absent.
Key features
- 01Routes requests by document type
- 02Loads matching writing instructions
- 03Updates requested parts of existing docs
- 04Runs discovery for new documents
- 05Archives feature folders
Use cases
- 01Drafting a product requirements document
- 02Writing a technical design or ADR
- 03Consolidating audit findings
- 04Moving completed features to cold storage
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ adeonir/ agent-skills --skill docs-writerAfter installing, type/docs-writerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mdagents/openai.yamlassets/adr.template.mddesign-doc.template.mdfeature-audit.template.mdfeature-design.template.mdfeature-prd.template.mdprd.template.mdproduct.template.mdinstructions/adr.mddesign.mdfeature-archive.mdfeature-audit.mdfeature-design.mdfeature-prd.mdprd.mdproduct.mdreferences/discovery.mdfeature-document.mdquality.mdreconcile.mdtracker-document.mdDetails
From the project READMEDocs Writer
Triggers
| Type | Load |
|---|---|
| PRD — product requirements | prd.md |
| Feature PRD — feature requirements | feature-prd.md |
| Feature Design Doc — feature technical design | feature-design.md |
| Audit report — consolidated findings from supplied audit outputs | feature-audit.md |
| PRODUCT — strategic positioning and identity | product.md |
| Design Doc — lean technical design and trade-offs | design.md |
| ADR — single architecture decision record | adr.md |
| Archive feature — move feature folders to cold storage | feature-archive.md |
Detect the document type from the trigger. If ambiguous, ask the user.
For a feature request that asks for both documents, load feature-prd.md first and then feature-design.md.
Workflow
trigger → detect type → load instruction → locate document → drafting
document exists → update the requested parts
document absent → full discovery
ADR → create a numbered record or update the requested record
archive → select feature folders → move to .artifacts/archive/features/
Comments
Markdown supported