skills.rest
ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak
ZainEldeen-Ashraf-Ibrahim-Ibrahim-SamakCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

speckit-clarify

Scan feature specs for ambiguities and generate up to five clarification questions.

Updated Apr 12, 2026
Search Tags:#automation#specification#validation#questions#spec-kit#feature-spec#clarify
One-click install
npx skills add https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT --skill speckit-clarify-zaineldeen-ashraf-ibrahim-ibrahim-samak
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT --skill speckit-clarify-zaineldeen-ashraf-ibrahim-ibrahim-samak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies ambiguous or missing decisions in an active feature specification and guides the author through up to five targeted clarification questions, then encodes accepted answers back into the spec file to reduce downstream rework.

Core Features & Use Cases

  • Automated ambiguity scanning: Performs a taxonomy-based coverage scan across functional scope, data model, UX flows, non-functional attributes, integrations, edge cases, constraints, and terminology.
  • Interactive clarification loop: Asks up to five prioritized, answer-constrained questions (multiple-choice or short answer), recommends answers with rationale, validates responses, and records them incrementally in the spec.
  • Spec integration & validation: Runs specified prerequisite hooks/scripts (for example the .specify check-prerequisites script), ensures a Clarifications session is created, writes atomic updates to the feature spec, and validates consistency after each change.
  • Use Case: Product managers or engineers preparing a feature spec can run this Skill to surface missing acceptance criteria, reduce ambiguity, and create testable decisions before planning.

Quick Start

Ask speckit-clarify to find missing decisions in the current feature spec and start the interactive clarification session.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify missing requirements in a feature specification?▼

To identify missing requirements in a feature specification, scan the document for ambiguities across functional scope, data models, and edge cases. This process generates targeted clarification questions to surface undocumented decisions before development begins.

What is specification clarification and how does it reduce rework?▼

Specification clarification is the process of finding underspecified areas in a feature spec and asking prioritized questions to fill those gaps. Encoding confirmed answers directly into the spec file reduces downstream rework by creating testable decisions early.

How do I validate ambiguous feature specs using a spec-kit structure?▼

You validate ambiguous feature specs by running prerequisite hooks within your spec-kit environment, then scanning the feature spec for missing constraints. The system writes atomic updates to the spec and validates consistency after each clarification is added.

Does the specification clarification process support multiple-choice questions?▼

Yes, the specification clarification process supports constrained answer formats including multiple-choice and short answers. It recommends answers with rationale, validates responses, and incrementally records confirmed decisions back into the specification.

What are the limitations of automating spec clarification for product management?▼

A limitation of automating spec clarification is that the interactive loop is constrained to a maximum of five targeted questions per session. It prioritizes high-impact ambiguities but cannot cover every possible edge case without manual intervention.

Related Skills

Explore More Product & Management Skills→
kamalsroor1kamalsroor1

speckit-clarify

Identify underspecified areas in a feature specification and integrate clarifications.

Community
Advanced
arbiterForgearbiterForge
139

brainstorming

Refine rough feature ideas into approved, testable specifications with acceptance criteria.

Official
Advanced
TKlerxTKlerx

speckit-analyze

Analyze spec.md, plan.md, and tasks.md for consistency and quality.

Community
Advanced
srnnklssrnnkls

clarify

Resolve ambiguities by updating documents with tracked changes.

Community
Advanced