ask_user — Claude Code prompt: what it does and how to install
The ask_user Claude Code prompt asks for missing details or a decision. Short answer choices appear as buttons.
Apache-2.0 ★ 9,488 updated 2026-11-16
.claude/commands/ask_user.mdWhat ask_user does
ask_user asks the user to fill in missing information or choose between options. When there are two to five brief choices, it sends them as buttons instead of writing them into the message or final response. Open-ended questions have no choice buttons.
Passwords and verification puzzles go through hand_to_user only when the agent cannot handle that step itself. The user's reply becomes the result. If no reply arrives in time, no_answer is an error, not a response: the agent proceeds with the most reasonable interpretation and says so, or stops with end_not_done if the task cannot continue without the answer.
To install it in Claude Code, place the prompt file at .claude/commands/ask_user.md.
What it helps with
- ask for missing project requirements
- let the user pick from a few short options
- continue a task after a reply does not arrive
- route a password or verification puzzle to another tool
Example prompts for the agent
- Ask me for any missing requirements before changing the code.
- Have me choose between the available options.
- If you need more information to proceed, ask me an open-ended question.
How to install ask_user
Manually: put the files in place
.claude/commands/ask_user.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about ask_user
How do I install ask_user in Claude Code?
Place the prompt file at .claude/commands/ask_user.md.
What does ask_user do?
It asks for missing details and presents brief choices as buttons. If no reply arrives in time, the agent uses the most reasonable interpretation or stops if the task depends on the answer.
How does ask_user handle passwords and verification puzzles?
It routes them to hand_to_user only when the agent cannot complete that step itself.
Source text
ask_user.md · Apache-2.0
Ask the user a question when information is missing or a choice is theirs to make; when the answer is one of a few short choices (2 to 5), always pass them as options, which show as buttons the user taps, and do not list those choices in the message text or in a final answer; leave options out only for open questions. Passwords and verification puzzles are not asked here: those go to hand_to_user, and only when the tools cannot do the step. The result holds the user's answer. If no answer comes in time you get error no_answer, which is not an answer: carry on with the most sensible reading and say so in your reply, or end_not_done if the task cannot continue without it.
© wangzan101 · Apache-2.0 · wangzan101/Mika