What problem does it solve? Feature specifications often contain ambiguities, vague adjectives, and missing decision points that cause rework during planning and implementation. This Skill systematically scans a spec-kit feature spec, asks up to 5 high-impact clarification questions, and writes the answers directly back into the spec. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec against a taxonomy covering functional scope, data model, UX flows, non-functional requirements, integrations, edge cases, and terminology. - Interactive Questioning Loop: Asks one question at a time (multiple-choice or short answer) with a recommended option and reasoning, capped at 5 questions per session. - Incremental Spec Updates: Appends each accepted answer to a ## Clarifications session section and updates the relevant spec sections, then re-validates the requirements checklist. - Use Case: Before running /speckit-plan, a developer runs clarification on a new feature spec; the Skill identifies that authentication requirements and data retention rules are undefined, asks targeted questions, and records the decisions in the spec. ## Quick Start Run the speckit-clarify skill to review my current feature spec and ask me clarification questions about any ambiguous requirements.
