speckit-specify

Generate feature specifications and checklists from natural language descriptions.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-specify-misadecastro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/misadecastro/imperial-soccer/tree/main/.claude/skills/speckit-specify
Command: npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-specify-misadecastro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms informal, natural-language feature descriptions into a complete, planning-ready feature specification and associated branch so teams can move from idea to planning without manual spec writing or checklist creation.

Core Features & Use Cases

  • Generates a concise short name for the feature branch and invokes the project's create-new-feature script with appropriate flags (timestamp vs sequential) to create and check out the branch.
  • Produces a specification file from the .specify/templates/spec-template.md by extracting actors, actions, data, constraints, user scenarios, functional requirements, success criteria, and key entities, and writes a quality checklist to FEATURE_DIR/checklists/requirements.md.
  • Runs a checklist-driven validation loop (up to 3 iterations), surfaces up to three critical clarifications when needed, and reports branch name, spec path, and readiness; can surface optional or automatic extension hooks before and after specification.
  • Use Case: Product managers or technical writers supply a short feature description and receive a branch with a validated spec and checklist, ready for planning or clarification.

Quick Start

Use /speckit.specify followed by a short natural-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 generate a feature specification from a natural language description?

Create a feature specification by inputting a natural language description; the system parses it to extract actors, actions, and data, generating a spec file from a template. It also creates a quality checklist for requirements validation.

Can I automate branch creation when writing a new feature spec?

Yes, branch creation is automated during specification. The system generates a concise short name for the feature branch and invokes the project's create-new-feature script with appropriate flags to create and check out the branch automatically.

Do I need a spec-kit directory structure to use this feature specification workflow?

Yes, this workflow requires a spec-kit structure with a .specify directory. It relies on the project's create-new-feature script and accesses templates like spec-template.md to generate specification files and checklists in the correct feature directory.

How does checklist-driven validation work for feature specs?

Checklist-driven validation runs an automated loop of up to 3 iterations to verify the generated specification against requirements. It surfaces up to three critical clarifications when needed, ensuring the spec is planning-ready and reporting its readiness.

What is the best way to turn informal feature ideas into planning-ready spec files?

Transform informal feature ideas into planning-ready spec files by using a natural language description input. The system extracts key entities, functional requirements, and success criteria to produce a validated specification and associated branch without manual writing.