clarify-vague

Installation
SKILL.md

Vague: Requirement Clarification

Transform vague or ambiguous requirements into precise, actionable specifications through hypothesis-driven questioning. ALWAYS use the AskUserQuestion tool — never ask clarifying questions in plain text.

When to Use

  • Ambiguous feature requests ("add a login feature")
  • Incomplete bug reports ("the export is broken")
  • Underspecified tasks ("make the app faster")

For strategy/planning blind spot analysis, use the clarify-unknown skill. For content-vs-form reframing, use the clarify-metamedium skill.

Core Principle: Hypotheses as Options

Present plausible interpretations as options instead of asking open questions. Each option is a testable hypothesis about what the user actually means.

BAD:  "What kind of login do you want?"           ← open question, high cognitive load
GOOD: "OAuth / Email+Password / SSO / Magic link" ← pick one, lower load
Related skills

More from team-attention/heum-workshop

Installs
3
First Seen
Apr 17, 2026