speckit-clarify

Identify ambiguities in feature specs and generate prioritized clarifying questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the active feature specification by prompting up to 5 targeted clarification questions and recording answers back into the spec to reduce ambiguity and rework.

Core Features & Use Cases

  • Up to 5 targeted clarification questions per session, prioritized by impact and uncertainty.
  • Automatic embedding of accepted answers into a dedicated Clarifications section in the spec for traceability.
  • Pre-flight checks requiring a spec-kit project structure and the ability to load and modify the current FEATURE_SPEC.
  • If ambiguity is detected across multiple categories, generate a prioritized question queue and guide the planning phase to minimize downstream rework.

Quick Start

Run the speckit clarification workflow on the current feature spec to identify ambiguities and encode clarifications directly in the spec.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify ambiguities in my feature specification to reduce rework?

Identify ambiguities in your feature specification by generating up to 5 targeted clarifying questions prioritized by impact. Applying a taxonomy of functional scope, data model, and edge cases captures underspecified areas early in the planning phase to minimize downstream rework.

What is the best way to track clarifications and answers directly within a project spec?

Track clarifications by embedding accepted answers into a dedicated Clarifications section within your feature specification. This ensures traceability by updating the spec with short, machine-parseable responses after each accepted answer during the workflow.

How do you prioritize clarification questions when a spec has multiple ambiguous categories?

When a spec has multiple ambiguous categories, prioritization is driven by impact and uncertainty. The tool generates a prioritized question queue across data model, UX flow, non-functional attributes, integration, and constraints to guide the planning phase systematically.

Do I need a spec-kit project structure to run the clarification workflow?

Yes, the clarification workflow requires a spec-kit project structure. Pre-flight checks confirm the ability to load and modify the current FEATURE_SPEC before identifying spec gaps and generating targeted clarifications.

What format should answers have when updating the feature specification?

Answers must be short, machine-parseable responses. Once accepted, the tool updates the feature specification with these constrained answers in a dedicated Clarifications section to maintain structure and reduce ambiguity.

What categories of ambiguity should I look for when defining software requirements?

When defining software requirements, evaluate ambiguity across a taxonomy covering functional scope, data model, UX flow, non-functional attributes, integration, edge cases, and constraints to ensure comprehensive specification coverage.