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.