sp-specify

Generates planning-ready specification packages from feature requests through guided requirement discovery.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/chenziyang110/launchdeck --skill sp-specify-chenziyang110
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sp-specify
Source: https://github.com/chenziyang110/launchdeck/tree/main/.claude/skills/sp-specify
Command: npx skills add https://github.com/chenziyang110/launchdeck --skill sp-specify-chenziyang110

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a raw or ambiguous feature request into a specification that a planner can act on requires structured discovery, ambiguity resolution, and traceability checks. This Skill guides that process inside a spec-kit project, producing a canonical spec contract and human-readable spec without writing implementation code. ## Core Features & Use Cases - Guided Requirement Discovery: Asks one high-impact question at a time, decomposes ambiguous terms, compares approaches, and confirms scope before writing artifacts. - Discussion Handoff Compilation: Validates a confirmed sp-discussion handoff contract and compiles it into a specification with semantic-delta tracking, avoiding repeated user review. - Deterministic Quality Gates: Runs self-review for placeholders, contradictions, dropped upstream signals, and missing acceptance proof before recommending the next workflow command. - Use Case: A user describes a new CLI feature in vague terms; the Skill clarifies scope, records semantic term decisions, writes spec-contract.json and spec.md, then routes to /sp.plan once planning-ready. ## Quick Start Invoke the skill with a description of the feature you want specified, such as asking it to specify a new command that scaffolds project templates.

Frequently Asked Questions about sp-specify

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

FAQPage Schema
How do I turn a feature request into a specification with spec-kit?▼

Invoke the sp-specify skill with a description of the feature. It creates a feature workspace, asks one high-impact clarification question at a time, then writes spec-contract.json and a rendered spec.md ready for the planning stage.

What is the difference between discovery mode and compile mode in sp-specify?▼

Discovery mode handles raw feature requests through interactive clarification. Compile mode starts from a confirmed sp-discussion handoff contract, computes a semantic delta, and skips repeated user review when nothing material changed.

Does sp-specify require a spec-kit project structure?▼

Yes. The skill requires a spec-kit project with a .specify directory, including templates and the create-feature script. It also uses the specify CLI workflow runtime to manage workflow-state.md transitions.

Can sp-specify handle UI design references like screenshots or mockups?▼

Yes. It detects screenshots, HTML/CSS mockups, design exports, and reference URLs, asks for a fidelity mode (approximate, high, or inspiration), and dispatches a dedicated lane to write ui-reference-notes.md and ui-brief.md.

Why does sp-specify stop with blocked_by_handoff_integrity?▼

This happens when a discussion workspace looks specification-ready but lacks a valid handoff-to-specify.json contract with handoff-ready status and a user-confirmed quality gate. Route back to sp-discussion to write or repair the contract.

When should I use sp-clarify instead of sp-specify?▼

Use sp-specify first for guided discovery; it routes to sp-clarify only when planning-critical ambiguity remains after its question cadence. sp-specify will not recommend sp.plan while unresolved ambiguity or unconfirmed scope reductions exist.