speckit-clarify

Identify underspecified areas in feature specifications and prompt targeted clarification questions.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/vZulin/overlay-clock-timer --skill speckit-clarify-vzulin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/vZulin/overlay-clock-timer/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/vZulin/overlay-clock-timer --skill speckit-clarify-vzulin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in feature specifications by prompting up to five targeted clarification questions and encoding the answers back into the spec for traceability.

Core Features & Use Cases

  • Automated clarification workflow: detects gaps, asks targeted questions, and records responses in the spec.
  • Traceable spec updates: encodes answers into the SPEC to reduce rework and misalignment.
  • Use Case: when a feature spec has vague acceptance criteria, run speckit-clarify to surface concrete questions and update the spec accordingly.

Quick Start

Provide your initial specification and run the clarifier to generate focused, actionable questions.

Frequently Asked Questions about speckit-clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify gaps in a feature specification before development starts?

To clarify feature specifications, provide your initial specification and run the clarifier to generate focused, actionable questions. It enforces a strict one-question-at-a-time interaction to systematically resolve vague requirements.

How do I update a spec with clarification answers to maintain traceability?

Maintain traceability by storing clarification answers back into the specification. The tool records decisions in a dedicated Clarifications section within the spec-kit project structure to reduce rework and misalignment.

Does the spec-kit clarify tool work with an existing .specify project structure?

Yes, spec-kit clarification integrates directly with the existing .specify project structure. It records targeted clarification questions and answers within this dedicated directory to maintain specification traceability.

What is the limit on targeted clarification questions for a single feature spec?

The limit for targeted clarification questions is up to five per feature specification. This constraint ensures focused interactions that resolve underspecified areas without overwhelming the user during the clarification workflow.