speckit-specify

Generate a validated feature specification from a natural language feature description.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a complete, testable specification is slow and error-prone, often producing ambiguous requirements that derail planning. This Skill converts a natural language feature description into a structured spec file with user scenarios, functional requirements, and measurable success criteria. ## Core Features & Use Cases - Spec Generation: Creates a numbered feature directory under specs/ and writes a spec.md from the resolved spec template, persisting the path in .specify/feature.json for downstream commands. - Quality Validation: Builds a requirements checklist, validates the spec against content and completeness criteria, and iterates up to three times to fix failures. - Clarification Handling: Limits ambiguity to a maximum of three [NEEDS CLARIFICATION] markers and presents structured multiple-choice questions to resolve them. - Extension Hooks: Runs optional and mandatory before_specify and after_specify hooks defined in .specify/extensions.yml, such as automatic git branch creation. - Use Case: A product manager types a feature idea like "add OAuth2 login for the mobile app" and receives a ready-to-plan specification with acceptance scenarios and success metrics. ## Quick Start Ask the agent to run /speckit-specify followed by a plain-language description of the feature you want specified.

Frequently Asked Questions about speckit-specify

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

FAQPage Schema
How do I create a feature specification with spec-kit?▼

Run /speckit-specify followed by a natural language description of the feature. The command generates a short name, creates a numbered directory under specs/, writes spec.md from the resolved template, and validates it against a quality checklist.

How does speckit-specify handle unclear requirements?▼

It makes informed guesses using industry defaults and documents them in an Assumptions section. Only critical ambiguities become [NEEDS CLARIFICATION] markers, capped at three, each presented with suggested answer options for the user to choose.

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

Yes, it requires a project initialized with spec-kit containing a .specify/ directory. It reads .specify/init-options.json for numbering mode, resolves templates through the preset stack, and persists the feature path in .specify/feature.json.

Can speckit-specify create a git branch automatically?▼

Branch creation is delegated to a before_specify hook, typically from the git extension registered in .specify/extensions.yml. The core command always creates the spec directory and file itself, independent of branch naming.

What happens if the generated spec fails validation?▼

The command lists failing checklist items with quoted issues, updates the spec, and re-validates up to three iterations. If failures persist, remaining issues are documented in the checklist notes and the user is warned before proceeding.