skills.rest
dantasgut
dantasgutCOMMUNITY
Explore all skills by this author →
GitHub

speckit-clarify

Identify underspecified areas in feature specifications and prompt for targeted clarification questions.

Updated Mar 10, 2026
Search Tags:#documentation#specification#requirements#clarification#ambiguity#interactive
One-click install
npx skills add https://github.com/dantasgut/clayflow --skill speckit-clarify-dantasgut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/dantasgut/clayflow/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/dantasgut/clayflow --skill speckit-clarify-dantasgut

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies underspecified areas in a feature specification and prompts for up to five targeted clarification questions, encoding answers back into the spec to reduce ambiguity and downstream rework.

Core Features & Use Cases

  • Structured ambiguity detection across functional, data, UX, and non-functional areas.
  • Session-based clarifications that append to the spec and produce concrete, testable updates.
  • Interactive, one-question-at-a-time loop with recommended options to reduce rework risk.
  • Automatic capture of accepted answers and minimal, precise spec updates.

Quick Start

Run speckit-clarify against your current spec to begin a guided clarification session and append results to the spec.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify ambiguity in a feature specification before development?▼

Targeted clarification questions detect ambiguity in a feature specification by scanning functional, data, UX, and non-functional dimensions. The interactive session prompts up to five questions one at a time, exposing gaps to reduce downstream rework risk.

What is the best way to refine product specs with measurable acceptance criteria?▼

Refining product specs into measurable acceptance criteria involves an interactive clarification loop that captures accepted answers and appends them to the specification. This produces concrete, testable updates with date-stamped session tracking for traceability.

How do I update a feature spec to resolve underspecified requirements?▼

To resolve underspecified requirements in a feature spec, run a guided clarification session that appends answers to a Clarifications section. It automatically captures accepted answers and applies minimal, precise spec updates for measurable testable outcomes.

Does interactive specification clarification work for both functional and non-functional requirements?▼

Interactive specification clarification works for both functional and non-functional requirements by structuring ambiguity detection across functional, data, UX, and non-functional areas. This ensures comprehensive coverage of all specification dimensions during refinement.

What are the limitations of automated specification clarification for feature planning?▼

Automated specification clarification limits each interactive session to a maximum of five targeted questions to maintain focus. It concentrates on capturing precise answers and applying minimal spec updates rather than generating entirely new feature requirements from scratch.

Related Skills

Explore More Software Engineering Skills→
magdymohamed78magdymohamed78

speckit-clarify

Identify ambiguities in feature specifications and generate targeted clarification questions.

Community
Advanced
Agile-VAgile-V
50

requirement-architect

Convert product intent into traceable PRDs and user stories.

Official
Advanced
omerkllmomerkllm

speckit-clarify

Generate targeted clarification questions for feature specs and encode answers back into them.

Community
Advanced
aniruddh2003aniruddh2003
1

speckit.clarify

Identify underspecified areas in feature specifications and generate targeted clarification questions.

Community
Advanced