What problem does it solve? Feature specifications often contain ambiguities, missing decision points, and vague requirements that cause rework during planning and implementation. This Skill systematically scans a spec-kit feature spec, asks up to 5 targeted 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 attributes, integrations, edge cases, constraints, and terminology. - Interactive Questioning Loop: Presents 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: After running /speckit-specify to draft a feature spec, run this Skill before /speckit-plan to resolve open questions about security posture, scale assumptions, or acceptance criteria so downstream planning is not based on guesswork. ## Quick Start Ask the agent to run the speckit-clarify skill to review the current feature spec and resolve its ambiguities before planning.
