write-spec

Translate user stories into architecture, data model, and spec documentation.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/councilofwizards/wizards --skill write-spec-councilofwizards
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-spec
Source: https://github.com/councilofwizards/wizards/tree/main/plugins/conclave/skills/write-spec
Command: npx skills add https://github.com/councilofwizards/wizards --skill write-spec-councilofwizards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating cross-team spec writing is complex and error-prone; this Skill streamlines turning user stories into a complete specification with architecture, data model, and validation checkpoints.

Core Features & Use Cases

  • Cross-team orchestration for architecture and data modeling
  • ADRs, migrations, and staged Skeptic reviews
  • Generated specs published to docs/specs/{feature}/spec.md with progress and summary artifacts

Quick Start

Provide the user stories in docs/specs/{feature}/stories.md and run the write-spec skill to generate a draft specification.

Frequently Asked Questions about write-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate user stories into a complete technical specification?▼

To translate user stories into a complete technical specification, provide your inputs in a stories file and use a coordinated spec writing process to generate architecture, data models, and validation checkpoints.

What is the best way to coordinate cross-team architecture and data model design?▼

Coordinating cross-team architecture and data model design requires orchestrating staged checkpoints, role-specific outputs, and Skeptic reviews to ensure testable and auditable results across product and database concerns.

How do I generate an Architecture Decision Record for a new feature migration?▼

Generating an Architecture Decision Record for a feature migration involves evaluating user stories through staged validation, producing auditable role-specific outputs that document architecture and data model decisions.

Does this spec writing approach work for features requiring database migrations?▼

Yes, this spec writing approach works for features requiring database migrations by spanning product, architecture, and database concerns, enforcing requirements through staged checkpoints and Skeptic reviews.

What file format do I need to start writing a feature specification?▼

To start writing a feature specification, you need to provide user stories in a markdown file located at docs/specs/{feature}/stories.md to generate the draft specification output.

When should I use a Skeptic review in the spec writing process?▼

A Skeptic review should be used during the spec writing process as a staged checkpoint to enforce requirements, validate architecture and data model designs, and ensure the final specification is testable and auditable.