speckit-clarify

Generate targeted clarifying questions and commit accepted answers to a .specify spec.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Underspecified feature specs lead to costly rework and misaligned implementations. Speckit-clarify guides teams to surface and resolve ambiguities by eliciting up to 5 precise questions and encoding the answers back into the spec.

Core Features & Use Cases

  • Guided ambiguity detection across functional scope, data model, UX flows, non-functional criteria, and external dependencies.
  • Per-question integration: each accepted answer is committed to the spec as a separate change with a clear audit trail.
  • Works within a .specify project structure to ensure consistency between planning and execution.

Quick Start

Run /speckit-clarify in a SpecKit project to begin a guided ambiguity-resolution session and update the spec automatically.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I resolve ambiguities in my feature specification?

You can resolve ambiguities in a feature specification by using a guided tool to generate up to 5 targeted clarifying questions. It asks questions one at a time and applies accepted answers directly back into the spec file.

What is the best way to track requirement changes to a spec?

Tracking requirement changes to a spec is effectively done by committing each accepted clarifying answer as a separate git commit. This creates a clear audit trail directly within your version control history for every updated requirement.

How do I find missing non-functional criteria in project requirements?

Finding missing non-functional criteria in project requirements is done by running a guided ambiguity detection session. It scans your spec for gaps across functional scope, data models, UX flows, and external dependencies to surface underspecified areas.

Do I need a specific project structure to clarify feature specs?

Yes, a .specify project structure is required to clarify feature specs with this tool. The Skill operates within this specific directory structure to ensure consistency between your planning phase and execution phase.

What types of underspecified areas in a spec can be clarified?

Underspecified areas in a spec that can be clarified include core goals, data models, UX flows, non-functional criteria, and external dependencies. The detection covers all these dimensions to prevent misaligned implementations.