speckit-clarify

Generate clarifying questions for underspecified feature specifications and capture answers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Structured ambiguity detection across functional, domain, interaction, and non-functional categories.
  • Interactive clarification loop that caps at five questions and updates the spec after each answer.
  • Automatic integration of clarifications into a dedicated "Clarifications" section with session-level context.

Quick Start

Run the clarifier against the active spec to begin a structured ambiguity analysis and collect up to five targeted 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 underspecified areas in a feature specification?

To identify underspecified areas in a feature specification, run a structured ambiguity analysis that detects gaps across core goals, domain models, UX flows, non-functional constraints, and integration assumptions.

What is the best way to clarify requirements with stakeholders?

The best way to clarify requirements with stakeholders is using an interactive clarification loop that generates up to five targeted questions and encodes the answers directly back into the specification.

How do I update a spec with clarification answers from stakeholders?

You update a spec with clarification answers by automatically integrating each response into a dedicated Clarifications section, ensuring session-level context is captured to maintain a testable minimal-uncertainty approach.

Does this specification clarification tool support non-functional constraints?

Yes, this specification clarification tool supports non-functional constraints by explicitly including them in its structured ambiguity detection scope alongside functional, domain, and interaction categories.

What are the limitations of automated specification clarification?

A limitation of this automated specification clarification is that the interactive loop caps at five targeted questions per session, requiring multiple iterations if the feature specification has extensive ambiguity.