Skip to content
Agent Orchestration
Skill

/ask-user-questions

Ask clarifying questions to users via interactive TUI. Use when you need user input on preferences, implementation choices, or ambiguous instructions.

BOOST
From plugin
ask-user-questions-mcp
1461 skill
Install
$ npx -y skills add paulp-o/ask-user-questions-mcp --skill ask-user-questions --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/ask-user-questions

Context preview

The summary Claude sees to decide when to auto-load this skill.

Ask clarifying questions to users via interactive TUI. Use when you need user input on preferences, implementation choices, or ambiguous instructions.

SKILL.md

ask-user-questions.SKILL.md
name: ask-user-questions
description: Ask clarifying questions to users via interactive TUI. Use when you need user input on preferences, implementation choices, or ambiguous instructions.
license: MIT
metadata:
  author: paulp-o
  version: "3.3.1"

Ask User Questions

Use this tool when you need to ask the user questions during execution. This allows you to:

Gather user preferences or requirements Clarify ambiguous instructions Get decisions on implementation choices as you work Offer choices to the user about what direction to take. Usage notes:

Users will always be able to select "Other" to provide custom text input Use multiSelect: true to allow multiple answers to be selected for a question Recommend an option unless absolutely necessary, make it the first option in the list and add "(Recommended)" at the end of the label For multiSelect questions, you MAY mark multiple options as "(Recommended)" if several choices are advisable Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?"

Usage

# Ask questions via CLI
npx auq ask '{"questions": [...]}'

# Or pipe JSON input
echo '{"questions": [...]}' | npx auq ask

Parameters

{
  "questions": [
    {
      "prompt": "Which authentication method would you like to use?",
      "title": "Auth",
      "options": [
        {"label": "JWT (Recommended)", "description": "Stateless, scalable"},
        {"label": "Session cookies", "description": "Traditional, server-side"}
      ],
      "multiSelect": false
    }
  ]
}

| Field | Type | Required | Description | |-------|------|----------|-------------| | `questions` | array | Yes | 1-5 question objects | | `questions[].prompt` | string | Yes | Full question text | | `questions[].title` | string | Yes | Short label (max 12 chars) | | `questions[].options` | array | Yes | 2-5 options with `label` and optional `description` | | `questions[].multiSelect` | boolean | Yes | Allow multiple selections |

Read more
Ships withask-user-questions-mcp

AskUserQuestion pushed to the max A complete toolset that enables maximum level of human-(intention-)in-the-loop onto any long-running, multi-agentic AI workflows (like Ralph Loop!).

Get the whole plugin
Stats
146
Stars
21
Forks
Maintained
Maintenance
TypeScript
Language
MIT
License
4mo ago
Last commit
11mo ago
Created
4d ago
Added

Repo: paulp-o/ask-user-questions-mcp