What problem does it solve? Feature specifications often contain ambiguous requirements, missing edge cases, and vague non-functional criteria that cause rework during planning and implementation. This Skill systematically scans a spec-kit feature spec, asks up to five targeted clarification questions, and writes the accepted answers directly back into the spec. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec across a taxonomy covering functional scope, data model, UX flows, non-functional attributes, integrations, edge cases, constraints, and terminology, marking each category Clear, Partial, or Missing. - Interactive Questioning Loop: Presents one question at a time (maximum five) as multiple-choice with a recommended option or a constrained short answer, then validates and records each response. - Incremental Spec Updates: Appends each accepted answer to a ## Clarifications session section and applies it to the relevant spec section, saving the file after every integration. - Use Case: Before running /speckit-plan on a new feature branch, run this Skill to resolve open questions about authentication requirements, data retention, and error handling so the implementation plan is built on confirmed decisions. ## Quick Start Ask the assistant to run the speckit-clarify workflow on the current feature spec to identify and resolve its ambiguities.
