skills.rest
Powerworks
PowerworksCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

speckit-specify

Generates a validated feature specification from a natural language description in spec-kit projects.

Updated Aug 10, 2026
Search Tags:#specification#requirements#validation#clarification#spec-driven development#spec-kit#feature spec
One-click install
npx skills add https://github.com/Powerworks/Underwriting --skill speckit-specify-powerworks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/Powerworks/Underwriting/tree/main/.claude/skills/speckit-specify
Command: npx skills add https://github.com/Powerworks/Underwriting --skill speckit-specify-powerworks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a complete, testable specification is slow and error-prone. This Skill converts a natural language feature description into a structured spec.md file inside a spec-kit project, complete with user scenarios, functional requirements, success criteria, and a quality checklist. ## Core Features & Use Cases - Specification Generation: Parses a feature description and writes a full spec.md using the project's resolved spec-template, with numbered feature directories under specs/. - Quality Validation: Creates a requirements checklist and iteratively validates the spec against content quality, requirement completeness, and feature readiness criteria. - Clarification Handling: Limits ambiguity by inserting at most 3 [NEEDS CLARIFICATION] markers and presenting structured multiple-choice questions to resolve them. - Extension Hooks: Supports before_specify and after_specify hooks from .specify/extensions.yml, including optional git branch creation. - Use Case: A product manager types a feature idea like "add OAuth2 login" and receives a ready-to-plan specification at specs/003-oauth2-login/spec.md with a validated quality checklist. ## Quick Start Run /speckit-specify followed by a description of the feature you want to specify, such as "add 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 /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 based on the resolved spec-template.

How does speckit-specify handle unclear requirements?▼

It makes informed guesses using industry standards and documents assumptions, inserting at most 3 [NEEDS CLARIFICATION] markers for critical decisions. Each marker is presented as a structured question with suggested answer options for the user to resolve.

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, .specify/memory/constitution.md for governance, and persists the feature path to .specify/feature.json.

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 spec.md file.

What happens if the generated spec fails quality validation?▼

The command lists failing checklist items, updates the spec to fix each issue, and re-validates up to 3 iterations. If issues remain, they are documented in the checklist notes and the user is warned before proceeding to /speckit-clarify or /speckit-plan.

Related Skills

Explore More Software Engineering Skills→
Dangerdan9631Dangerdan9631
1

speckit-constitution

Create or update project constitutions and synchronize dependent templates in spec-kit projects.

Community
Advanced
FarooqProProgrammerFarooqProProgrammer

sdd-pipeline

Orchestrates spec-driven development from constitution through specification, planning, tasks, and implementation.

Community
Intermediate
bitpantrybitpantry

clarify

Clarify technical specifications through a guided Q&A process.

Community
Advanced
ArMaTeCArMaTeC

speckit-specify

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

Community
Advanced