speckit-specify

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

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-specify-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-specify
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-specify
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-specify-narenkarthikbm

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 plain-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 - Spec Generation: Creates a numbered feature directory under specs/ and writes a spec.md from the resolved spec-template, with at most 3 [NEEDS CLARIFICATION] markers for genuinely ambiguous decisions. - Quality Validation: Generates a requirements checklist and iteratively validates the spec against content quality, requirement completeness, and feature readiness criteria (up to 3 iterations). - Extension Hooks: Executes before_specify and after_specify hooks declared in .specify/extensions.yml, and persists the feature directory to .specify/feature.json for downstream commands like /speckit-plan. - Use Case: A developer types a feature idea such as "add OAuth2 login to the API" and receives a ready-to-plan specification with measurable, technology-agnostic success criteria. ## Quick Start Ask the assistant to create a feature specification by describing the feature you want, for example requesting a spec for 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 specify command with a natural language description of the feature. It generates a short name, creates a numbered directory under specs/, writes spec.md from the resolved template, and validates the result against a quality checklist.

How does spec-kit handle unclear feature requirements?

The specification step makes informed guesses using industry defaults and marks at most 3 items with [NEEDS CLARIFICATION] markers. Each marker is presented to the user with suggested answer options before the spec is finalized.

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

Yes, it requires an initialized spec-kit project with a .specify/ directory. It reads .specify/init-options.json for numbering configuration and persists the feature directory to .specify/feature.json for downstream commands.

Can I customize the feature directory name in spec-kit?

Yes, you can explicitly provide SPECIFY_FEATURE_DIRECTORY to override the default. Otherwise the directory is auto-generated under specs/ using either a sequential 3-digit number or a timestamp prefix plus a short feature name.

What are before_specify and after_specify hooks?

They are extension hooks declared in .specify/extensions.yml that run before or after specification. Hooks can be optional or mandatory, and disabled hooks or those with unevaluated conditions are skipped.