Ask User Skill Skill | Agent Skills

Ask User Skill

Pattern for effective user interaction.

When to Load This Skill

You need to clarify requirements
You need user to make a decision
You have options to present

Principles

1. Be Specific, Not Open-Ended

Bad: "What do you want?" Good: "Should authentication use JWT or sessions?"

2. Offer Options When Possible

AskUserQuestion(
  questions: [
    {
      question: "Which authentication method should we use?",
      header: "Auth method",
      options: [
        { label: "JWT", description: "Stateless, good for APIs" },
        { label: "Sessions", description: "Stateful, good for web apps" }
      ],
      multiSelect: false
    }
  ]
)

3. Provide Context

Explain WHY you're asking:

What decision depends on this
What trade-offs exist
What you recommend and why

4. Batch Related Questions

Ask related questions together:

questions: [
  { question: "Auth method?", ... },
  { question: "Token expiry?", ... },
  { question: "Refresh token?", ... }
]

When to Ask vs Decide

ASK when:

Multiple valid approaches with different trade-offs
User preference matters
Scope is unclear
Risk of wasted work

DECIDE when:

Clear best practice exists
Low impact choice
Easily reversible
Standard convention applies

Question Types

Clarification

"You mentioned 'fast' - do you mean response time < 100ms or just faster than current?"

Confirmation

"I understand you want X, Y, and Z. Is this correct?"

Decision

"Option A has [pros/cons]. Option B has [pros/cons]. Which do you prefer?"

Scope

"Should this also handle [related case] or just [original request]?"

Agent Skills: Ask User Skill

Install this agent skill to your local

Skill Files