speckit-specify

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

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/stefaniuk/loadout --skill speckit-specify-stefaniuk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/stefaniuk/loadout/tree/main/.github/skills/speckit-specify
Command: npx skills add https://github.com/stefaniuk/loadout --skill speckit-specify-stefaniuk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a complete, testable specification is slow and inconsistent across teams. This Skill converts a natural language feature description into a structured spec.md file with user scenarios, functional requirements, and measurable success criteria, then validates it against a quality checklist. ## Core Features & Use Cases - Specification Generation: Parses a feature description into actors, actions, data, and constraints, then writes a spec following the spec-kit template with at most 3 [NEEDS CLARIFICATION] markers. - Quality Validation: Creates a requirements checklist and iterates on the spec (up to 3 passes) until content quality, requirement completeness, and feature readiness checks pass. - Extension Hooks: Executes before_specify and after_specify hooks from .specify/extensions.yml, including git branch creation, and persists the feature directory to .specify/feature.json for downstream commands. - Use Case: A product engineer types a feature idea like "add OAuth2 login for the mobile app" and receives a numbered spec directory (e.g., specs/003-oauth2-login) containing a validated spec.md ready for /speckit-clarify or /speckit-plan. ## Quick Start Ask the agent to run the speckit-specify skill with your feature description, for example: create a specification for adding user authentication with OAuth2.

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 the speckit-specify skill with a natural language feature description as the argument. It generates a short name, creates a numbered directory under specs/, copies the resolved spec-template, and writes a complete spec.md with requirements and success criteria.

How does spec-kit handle unclear requirements in a specification?▼

The skill makes informed guesses using industry standards and documents them in an Assumptions section. It adds at most 3 [NEEDS CLARIFICATION] markers for decisions that significantly impact scope, security, or user experience, then presents multiple-choice questions to resolve them.

Does speckit-specify require a specific project structure?▼

Yes, it requires a spec-kit project with a .specify/ directory. It reads .specify/init-options.json for feature numbering, optionally loads .specify/memory/constitution.md for governance constraints, and persists the feature path to .specify/feature.json.

Can I use speckit-specify with the Superpowers workflow mode?▼

No, the skill enforces a workflow mode guard and only runs when the active mode is speckit. If the mode is superpowers, it stops and instructs you to switch with make workflow-use mode=speckit.

What happens after the specification is written?▼

The skill validates the spec against a quality checklist covering content quality, requirement completeness, and feature readiness, iterating up to 3 times. It then runs any after_specify extension hooks and reports the feature directory, spec file path, and checklist results.