docs-writer

Original：🇺🇸 English

Translated

Generate structured product and technical documents through guided discovery. 8 document types: PRD, Brief, Issue, Task, User Story, RFC, ADR, TDD. Use when: defining products, reporting bugs, planning sprints, writing stories, proposing changes, recording decisions, designing systems. Triggers on "create PRD", "create issue", "report bug", "feature request", "create task", "create user story", "create RFC", "create ADR", "create TDD", "create document", "write doc".

2installs

Sourceadeonir/agent-skills

Added on2026-02-20

NPX Install

npx skill4agent add adeonir/agent-skills docs-writer

SKILL.md Content

View Translation Comparison →

Docs Writer

Generate structured documents through guided discovery. 8 document types, each with its own workflow depth.

Workflow

trigger --> detect type --> load reference --> discovery --> drafting

Detect document type from the trigger. If ambiguous, ask the user which type they want.

Document Types

Type	Workflow	Reference	Template
PRD	discovery -> validation -> synthesis -> drafting	prd.md	prd.md
Brief	generated with PRD (no separate trigger)	brief.md	brief.md
Issue	classification -> drafting	issue.md	issue.md
Task	direct drafting	task.md	task.md
User Story	discovery -> drafting	user-story.md	user-story.md
RFC	discovery -> analysis -> drafting	rfc.md	rfc.md
ADR	discovery -> drafting	adr.md	adr.md
TDD	discovery -> analysis -> drafting	tdd.md	tdd.md

Triggers

Trigger Pattern	Type	Reference
Create PRD, define product, product requirements, write PRD	PRD	prd.md
Create issue, report bug, feature request, create discussion	Issue	issue.md
Create task, sprint task, new task	Task	task.md
Create user story, write story, new story	User Story	user-story.md
Create RFC, propose change, request for comments	RFC	rfc.md
Create ADR, record decision, architecture decision	ADR	adr.md
Create TDD, technical design, design document	TDD	tdd.md
Create document, write doc	Ask user	--

Shared Discovery Patterns

LOAD: discovery.md before starting any type that requires discovery.

Discovery applies to: PRD, Issue (feature/discussion subtypes), User Story, RFC, ADR, TDD. Discovery does NOT apply to: Task, Issue (bug subtype -- uses structured reproduction instead), Brief (generated as part of PRD workflow).

Output

All documents save to

.specs/docs/

. Create the directory if it doesn't exist.

Type	Filename
PRD	`prd.md`
Brief	`brief.md`
Issue	`issue.md`
Task	`task.md`
User Story	`story.md`
RFC	`rfc.md`
ADR	`adr-{number}-{name}.md`
TDD	`tdd.md`

For ADR, use kebab-case for

{name}

and auto-detect the next sequential number from existing files in

.specs/docs/

.

Quality Standards

Requirements must be concrete and measurable across all document types.

Bad	Good
"Search should be fast"	"Search returns results within 200ms"
"Easy to use"	"New users complete onboarding in under 2 minutes"
"Intuitive interface"	"Task completion rate above 90% without help text"

Guidelines

DO:

Always complete discovery before drafting (for types that require it)
Present draft for user feedback before saving
Mark unknowns as TBD rather than inventing constraints
Use concrete, measurable requirements
Use fixed filenames per type (ADR keeps
```
{name}
```
suffix in kebab-case)

DON'T:

Skip discovery for types that require it
Assume document type -- detect from trigger or ask
Include visual/design direction (that belongs in design-builder)
Use vague adjectives as requirements ("fast", "easy", "intuitive")
Mix document types in a single file

Cross-References

docs-writer -----> spec-driven    (any doc can feed into a spec)
docs-writer -----> design-builder (PRD informs copy and design extraction)
RFC -------------> ADR            (accepted RFC generates ADR)
TDD -------------> ADR            (references relevant decisions)

Integration with Other Skills

design-builder: PRD sections 1-5 (problem, goals, value prop, competitive landscape, personas) inform copy extraction and design extraction
spec-driven: Any document can be input for feature initialization when implementation is complex

Error Handling

No
```
.specs/docs/
```
: Create the directory
Ambiguous trigger: Ask user which document type
Missing context for discovery: Ask questions, never assume
ADR numbering conflict: Scan existing files and use next available number