spec

Generates a detailed system specification from a project's scope and README files.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/zabuuq/sdd-plugin --skill spec-zabuuq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/zabuuq/sdd-plugin/tree/main/plugins/sdd/skills/spec
Command: npx skills add https://github.com/zabuuq/sdd-plugin --skill spec-zabuuq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill turns your PRD and scope into a detailed, architecture-grade technical specification that reduces ambiguity and accelerates implementation.

Core Features & Use Cases

  • Architecture-by-epic specs: Proposes each technical component mapped to specific PRD epics, including interfaces, contracts, and data shapes.
  • Granular, build-referenced structure: Produces deeply structured ##/### sections so downstream sprint planning can load the right context.
  • Complete engineering artifacts: Generates docs/spec.md, and updates or creates CLAUDE.md and AGENTS.md so agents have stable project instructions.

Quick Start

Run the command /sdd:spec after you have created docs/scope.md and docs/prd.md, and answer the single-question interview prompts to produce docs/spec.md.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I convert a PRD into a technical specification for engineering?

To convert a PRD into a technical specification, you load existing project scope and PRD files, run a guided multi-step interview, and generate a structured spec document covering architecture, data models, and deployment guidance.

How does spec-driven development map architecture to PRD epics?

Spec-driven development maps architecture to PRD epics by proposing each technical component with specific interfaces, contracts, and data shapes matched to the corresponding epic requirements in the generated specification.

What do I need to generate a buildable technical specification?

To generate a buildable technical specification, you need to create your project scope and PRD markdown files first, then execute the generation command and answer single-question interview prompts to refine the output.

Can I use this workflow to update agent instructions like CLAUDE.md and AGENTS.md?

Yes, the workflow updates or creates CLAUDE.md and AGENTS.md alongside the main specification document, ensuring that downstream agents have stable, cross-referenced project instructions for subsequent build steps.

Why does technical specification generation require a guided multi-step interview?

Technical specification generation requires a guided multi-step interview to deepen context through successive rounds, ensuring the final architecture, file structure, and data models precisely reflect the project scope and reduce ambiguity.

What is the best way to structure documentation for downstream sprint planning?

The best way to structure documentation for sprint planning is to generate deeply nested section headers with granular component subsections and documentation URLs, allowing context loading for specific build tasks.