speckit-clarify

Ask targeted questions to clarify underspecified feature specifications and write answers back.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/chuanyue98/prompt-gallery --skill speckit-clarify-chuanyue98
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/chuanyue98/prompt-gallery/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/chuanyue98/prompt-gallery --skill speckit-clarify-chuanyue98

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

speckit-clarify finds ambiguity and missing decision points in a feature specification, then asks up to five targeted questions to reduce downstream rework.

Core Features & Use Cases

  • Ambiguity & coverage scanning: Reviews the spec across goals, data model, UX flow, non-functional requirements, integrations, edge cases, constraints, and terminology consistency.
  • Interactive clarification loop: Asks exactly one question at a time using constrained answers (multiple-choice or short answers capped at 5 words).
  • Incremental spec updates: Writes accepted answers back into the appropriate sections of the feature spec and records a session trail under Clarifications.

Quick Start

Run /speckit.clarify in the feature-specified project directory to prompt for missing or underspecified choices and immediately update the spec with your answers.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I clarify ambiguous feature specifications before development?▼

Spec clarification resolves ambiguous feature specifications by scanning for gaps in data modeling, UX flows, and non-functional requirements, then asking up to five targeted questions to update the spec incrementally and prevent downstream rework.

What is structured ambiguity scanning for product requirements?▼

Structured ambiguity scanning is a spec clarification process that reviews product requirements across goals, edge cases, integrations, and terminology consistency to identify missing decision points before implementation begins.

How do I update underspecified non-functional requirements in a feature spec?▼

To update underspecified non-functional requirements, run an interactive clarification loop that asks constrained questions one at a time, then writes accepted answers directly back into the appropriate spec sections.

Can I use interactive Q&A to resolve edge cases in data modeling?▼

Yes, interactive Q&A resolves data modeling edge cases by asking exactly one targeted question at a time using multiple-choice or short answers capped at five words, then persisting the accepted choices into the spec.

What are the limitations of interactive spec clarification?▼

Interactive spec clarification is limited to asking a maximum of five targeted questions per session, constraining answers to multiple-choice or five-word short responses, and recording incremental updates within a session trail under Clarifications.