speckit-specify

Generates structured feature specifications from natural language descriptions using spec-kit templates.

Updated Jan 28, 2024
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/KrockSide --skill speckit-specify-thiago-cruz-eng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/Thiago-Cruz-eng/KrockSide/tree/main/.claude/skills/speckit-specify
Command: npx skills add https://github.com/Thiago-Cruz-eng/KrockSide --skill speckit-specify-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a complete, testable specification is slow and inconsistent. This Skill converts a natural language feature description into a structured spec.md file with user scenarios, functional requirements, and measurable success criteria, ready for planning. ## Core Features & Use Cases - Spec Generation: Creates a feature directory under specs/ with a spec.md based on the spec-kit template, including user scenarios, functional requirements, success criteria, and key entities. - Quality Validation: Generates a requirements checklist and iteratively validates the spec against completeness and testability criteria, resolving up to 3 NEEDS CLARIFICATION markers with the user. - Extension Hooks: Supports before_specify and after_specify hooks from .specify/extensions.yml, such as automatic git branch creation. - Use Case: A product manager types a feature idea like "add OAuth2 login" and receives a numbered spec directory (e.g., specs/003-oauth2-login/spec.md) with validated requirements ready for /speckit-plan. ## Quick Start Ask the assistant to run /speckit-specify followed by a 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 a natural language description of the feature. The command generates a short name, creates a numbered directory under specs/, and writes a spec.md from the spec-kit template with scenarios, requirements, and success criteria.

What does the speckit-specify command generate?▼

It generates a feature directory containing spec.md and a checklists/requirements.md quality checklist. It also records the feature directory path in .specify/feature.json so downstream commands like /speckit-plan can locate it.

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

Yes, it requires a project initialized with spec-kit, including the .specify directory with templates/spec-template.md. Without these templates the command cannot create the specification file.

How are clarification questions handled during specification?▼

The spec may contain up to 3 NEEDS CLARIFICATION markers for decisions that significantly affect scope, security, or user experience. Each is presented with suggested answer options in a table, and the spec is updated with the user's choices.

Can speckit-specify create a git branch automatically?▼

Branch creation is delegated to an optional before_specify hook defined in .specify/extensions.yml, typically provided by a git extension. The core command itself only creates the spec directory and files.