speckit-specify

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

9|2|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill speckit-specify-opsmill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/opsmill/infrahub-solution-ai-dc/tree/main/.agents/skills/speckit-specify
Command: npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill speckit-specify-opsmill

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 plain-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/ with a spec.md built from the resolved spec-template, including user scenarios, functional requirements, success criteria, and key entities. - Quality Validation: Generates a requirements checklist and iteratively validates the spec against content quality, completeness, and readiness criteria, with up to 3 clarification questions presented as option tables. - Extension Hooks: Executes before_specify and after_specify hooks from .specify/extensions.yml, supporting optional and mandatory hook flows 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 complete, validated specification at specs/003-oauth2-login/spec.md ready for /speckit-plan. ## Quick Start Ask the agent to run /speckit-specify followed by a natural language description of the feature you want to specify.

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 your feature description in natural language. The command generates a short name, creates a numbered directory under specs/, and writes a complete spec.md from the resolved spec-template.

What sections does a spec-kit specification include?▼

The spec includes user scenarios and testing, functional requirements, success criteria, and key entities when data is involved. Mandatory sections must be completed, while optional sections are included only when relevant to the feature.

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, .specify/memory/constitution.md for principles, and .specify/extensions.yml for hooks.

How are NEEDS CLARIFICATION markers handled in a spec?▼

The spec allows a maximum of 3 NEEDS CLARIFICATION markers for decisions that significantly impact scope, security, or user experience. Each is presented to the user as a question with suggested answer options in a table, then replaced with the chosen answer.

What happens after the specification is written?▼

The spec is validated against a quality checklist at checklists/requirements.md covering content quality, requirement completeness, and feature readiness. After validation and any after_specify hooks, the spec is ready for /speckit-clarify or /speckit-plan.