Clarify Skill

Review specifications for product clarity and completeness. Focus exclusively on what the user experiences — not how it's built.

When to Activate

This skill is relevant when:

Always write the review to a markdown file alongside the spec:

Path: <spec-directory>/clarification-review.md
Every gap, question, and missing scenario must include a Recommendation — a concrete suggestion for what to add or change in the spec to resolve it.
End the file with a Verdict: APPROVED (no critical gaps) or NEEDS REVISION (critical/important gaps found).

Review specifications for product clarity and completeness. Focus exclusively on what the user experiences — not how it's built.

This skill is relevant when:

Always write the review to a markdown file alongside the spec:

Path: <spec-directory>/clarification-review.md
Every gap, question, and missing scenario must include a Recommendation — a concrete suggestion for what to add or change in the spec to resolve it.
End the file with a Verdict: APPROVED (no critical gaps) or NEEDS REVISION (critical/important gaps found).