speckit.clarify

Identify underspecified areas in feature specifications and update them with clarifying questions.

63|13|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/compnew2006/Spec-Kit-Antigravity-Skills --skill speckit-clarify-compnew2006
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit.clarify
Source: https://github.com/compnew2006/Spec-Kit-Antigravity-Skills/tree/main/skills/speckit.clarify
Command: npx skills add https://github.com/compnew2006/Spec-Kit-Antigravity-Skills --skill speckit-clarify-compnew2006

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.

Core Features & Use Cases

  • Ambiguity detection across functional, data, UX, and non-functional domains
  • Structured, finite clarification loop that updates the spec after each accepted answer
  • Traceable changes with a dedicated Clarifications section in the spec

Quick Start

Invoke the clarification workflow to identify ambiguities in the current spec and iteratively update it after each accepted answer.

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 a feature specification before development starts?

Clarify a feature specification by running a structured questioning loop that asks up to 5 targeted questions to detect ambiguities across functional, data, UX, and non-functional domains. Accepted answers are encoded directly back into the spec to ensure traceable decisions.

Why does my software requirements document lead to rework during the QA phase?

Software requirements lead to QA rework when functional requirements and terminology are underspecified. A targeted clarification workflow prevents this by detecting ambiguities early and establishing measurable definitions of done before development begins.

How do I update a specification document to ensure traceability for accepted decisions?

Update a specification for traceability by appending accepted answers to a dedicated Clarifications section after each targeted question. This finite loop ensures every clarified decision is encoded back into the spec with measurable definitions of done.

Can I use a structured questioning workflow to define non-functional attributes and UX flows?

Yes, a structured questioning workflow defines non-functional attributes and UX flows by detecting ambiguities across these specific domains. It generates up to 5 targeted clarification questions to ensure all spec areas have measurable definitions of done.

What is the best way to resolve underspecified terminology in a feature spec?

The best way to resolve underspecified terminology in a feature spec is to invoke a structured clarification loop that asks targeted questions. This workflow identifies ambiguous terms and updates the specification after each accepted answer to ensure traceable decisions.

What are the limitations of using an automated clarification loop for requirements gathering?

The limitation of this clarification loop for requirements gathering is its finite scope of up to 5 targeted questions per iteration. If a feature specification has extensive ambiguities across data models and UX flows, multiple sequential loops are required to achieve full traceability.