speckit-clarify

Detect ambiguities in feature specs and generate prioritized clarifying questions.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/raccioly/coach-gravity --skill speckit-clarify-raccioly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/raccioly/coach-gravity/tree/main/.agent/skills/speckit-clarify
Command: npx skills add https://github.com/raccioly/coach-gravity --skill speckit-clarify-raccioly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and reduces ambiguity in active feature specifications by guiding structured clarifications and recording answers directly in the spec file.

Core Features & Use Cases

  • Structured ambiguity/coverage scan across Functional Scope & Behavior, Domain & Data Model, Interaction & UX Flow, Non-Functional Attributes, Integration & External Dependencies, Edge Cases, Constraints & Tradeoffs, Terminology, and Completion Signals.
  • Generates a prioritized, capped queue of clarifying questions (max 5) to minimize downstream rework.
  • Integrates answers into a dedicated Clarifications session in the spec and applies changes to functional, data, UX, and non-functional sections.

Quick Start

Instruct your AI agent to run the Speckit clarifier against the current spec to surface and resolve ambiguities.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I clarify ambiguities in feature specifications before planning?

To clarify ambiguities in feature specifications, run a structured scan across functional scope, data models, UX flows, and non-functional constraints to identify gaps. This process generates prioritized clarifying questions and logs answers directly into the spec file to resolve underspecified requirements.

What is the best way to identify missing requirements in a product spec?

The best way to identify missing requirements is performing a structured coverage scan across domain models, interaction flows, edge cases, and integration dependencies. This surfaces underspecified areas and generates a capped queue of clarifying questions to minimize downstream rework.

How do you resolve underspecified scenarios for data models and user interactions?

You resolve underspecified scenarios for data models and user interactions by generating targeted clarifications. A structured ambiguity assessment scans these sections, produces up to five prioritized questions, and applies the session-based answers directly into the specification document.

Can I automatically update spec sections with clarification answers?

Yes, you can automatically update functional, data, UX, and non-functional spec sections with clarification answers. The system integrates responses from the clarification session directly into the corresponding specification sections to ensure the document reflects resolved ambiguities.

How many clarifying questions should I generate for a feature spec?

You should generate a maximum of five prioritized clarifying questions for a feature spec. Capping the queue at five targeted questions minimizes downstream rework while ensuring structured ambiguity assessment covers all critical planning decisions.

What sections does a spec ambiguity scan cover?

A spec ambiguity scan covers Functional Scope and Behavior, Domain and Data Model, Interaction and UX Flow, Non-Functional Attributes, Integration and External Dependency, Edge Cases, Constraints and Tradeoffs, Terminology, and Completion Signals to ensure comprehensive requirement clarification.