requirements-to-spec

Convert rough ideas and feature requests into structured SDD specifications with acceptance criteria.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill requirements-to-spec-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements-to-spec
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/requirements-to-spec
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill requirements-to-spec-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vague ideas, GitHub issues, and stakeholder notes often jump straight into code without clear scope, leading to rework and misaligned expectations. This Skill turns that rough input into a structured specification with defined scope, testable acceptance criteria, constraints, risks, and open questions before any coding begins. ## Core Features & Use Cases - Structured Spec Generation: Produces a consistent specification template covering problem, goal, scope, acceptance criteria, constraints, assumptions, risks, and suggested implementation waves. - Flexible Input Handling: Accepts rough ideas, GitHub issues, bug reports, feature requests, product requirements, or technical improvement requests. - Uncertainty Management: Forces assumptions and open questions to be explicit instead of inventing business rules silently. - Use Case: A product manager pastes a vague stakeholder request like "users want better notifications" and receives a complete spec with in-scope/out-of-scope boundaries, Given/When/Then acceptance criteria, and a review checklist ready for team approval. ## Quick Start Turn this GitHub issue about slow dashboard loading into a full specification with scope, acceptance criteria, and risks.

Frequently Asked Questions about requirements-to-spec

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

FAQPage Schema
How do I turn a vague feature request into a specification?

Feed the raw request into the skill and it identifies the problem, affected users, and expected value, then separates in-scope from out-of-scope items. It converts vague statements into testable Given/When/Then acceptance criteria and lists constraints, risks, and open questions.

What inputs does a requirements-to-spec workflow accept?

It accepts rough ideas, GitHub issues, stakeholder notes, bug reports, feature requests, product requirements, and technical improvement requests. Any unstructured requirement text can be converted into the standard specification format.

What is specification-driven development in AI coding workflows?

Specification-driven development is a workflow where requirements are clarified and written as structured specs before code is generated. It prevents AI agents from jumping straight from an idea to implementation, reducing rework and misaligned output.

Does the skill write implementation code from the spec?

No, it deliberately avoids implementation details and only suggests high-level implementation waves after the spec is clear. Coding and task execution are handled by downstream planning and orchestration steps in the SDD workflow.

When should I not use a spec generation skill?

Skip it for trivial changes like typo fixes or one-line configuration edits where a full spec adds overhead. It is designed for features, bugs, and improvements where scope ambiguity could cause wasted implementation effort.