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.