Specification Clarification

What problem does it solve?

This Skill eliminates ambiguous or incomplete specifications that lead to misinterpretations, rework, and delays during development. It systematically resolves unknowns before implementation begins, ensuring clarity and alignment.

Core Features & Use Cases

• Systematic Ambiguity Detection: Scans specifications against 10+ categories (e.g., functional scope, edge cases, non-functional requirements) to identify gaps.
• Prioritized, Structured Questioning: Generates up to 5 high-impact questions per iteration, with options and recommendations, to guide the user to clear answers.
• Incremental Specification Updates: Updates the spec.md file after each answer, ensuring consistency and preventing contradictions.
• Use Case: Your feature specification has [NEEDS CLARIFICATION] markers or feels vague. Use this Skill to engage in a focused dialogue, resolve all ambiguities, and refine your spec.md into a clear, actionable document, ready for planning.

Quick Start

To clarify an existing specification with ambiguities:

Ensure your spec.md is in specs/<feature-id>/spec.md

Then, simply invoke the skill:

/clarify specs/my-feature/spec.md