inbrainfun/inbrain/ask-user
Claude Code and agent skill by inbrainfun/inbrain
- community
Checking that the SKILL.md file is still in the repository.
Reusable pattern for presenting the user with explicit choices and gating execution until they respond. Used by other skills when a decision point requires human input before proceeding. Platform-agnostic — works on Telegram (inline buttons), Discord, CLI, or any agent with a message tool.
Install
npx vskill@latest install inbrainfun/inbrain/ask-userSKILL.md
The same SKILL.md was published earlier as inbrainfun/inbrain/ask-user.
Ask User — Choice Gate Pattern
Contract
- Present 2-4 options (no more — decision paralysis kicks in past 4).
- Always include an escape hatch (Skip, Cancel, or "none of these").
- Stop the turn immediately after presenting choices. No follow-up tool calls,
no preemptive action, no default-and-proceed.
- The user's response triggers the next turn. Acknowledge briefly, then branch.
- One question per message — never stack multiple choice gates.
- Self-explanatory option labels: action verb plus brief qualifier, not "Option 1".
What This Is
A formalized pattern for presenting users with 2-4 options and stopping execution until they respond. This is the canonical way to gate on user input in any Inbrain-powered agent.
This is NOT a traditional async/await. In an LLM agent, "gating" means:
- Present the choices (buttons or numbered options)
- Explicitly stop the current turn (do not proceed)
- The user's response triggers the next turn
- Read the response and branch accordingly
When To Use
- Ambiguous requests with multiple valid interpretations
- Destructive operations (bulk deletes, overwrites)
- Filing/routing decisions ("where should this go?")
- Priority triage ("which should I do first?")
- Cold-start phase gates ("ready for the next import source?")
- Any fork where the wrong default wastes significant work
When NOT To Use
- Clear, unambiguous instructions → just do it
- Low-stakes decisions → pick the best option and mention it
- Time-critical operations where delay costs more than a wrong choice
- When the user has already expressed a preference
How To Present Choices
Platform-agnostic format (works everywhere)
Present choices as a clear question with numbered or labeled options:
With inline buttons (Telegram, Discord, Slack)
If the platform supports interactive buttons, use them:
With the clarify tool (OpenClaw agents)
Some OpenClaw agents have a built-in clarify tool that presents choices natively:
Constraints
- 2-4 options max. More than 4 creates decision paralysis.
- Labels must be self-explanatory. The user shouldn't need to re-read context.
- Always include an escape hatch. At minimum: "Skip" or "Cancel" as the last option.
- One question per message. Never stack multiple choice gates.
How To Gate (CRITICAL)
After presenting choices, you MUST stop your turn. Do not:
- ❌ Continue with "while you decide, I'll start on..."
- ❌ Pick a default and proceed
- ❌ Send follow-up messages before the user responds
- ❌ Make assumptions about which option they'll pick
Instead:
- ✅ End your message with a brief note that you're waiting
- ✅ Stop. Full stop. No more tool calls.
How To Handle The Response
When the user responds:
- Read the response — button click, number, or text
- Acknowledge briefly — "Got it, going with Option A."
- Branch and execute the chosen path
- If unclear, ask again
Handling text responses
Users sometimes type instead of clicking. Handle gracefully:
- "the first one" / "A" / "1" → map to first option
- "merge" → fuzzy match against option labels/values
- "actually, none of those" → present alternatives or ask what they want
- Unrelated message → the user moved on; drop the gate
Formatting Guidelines
Question line emoji prefix
Signal the decision type:
- 🔀 Routing/filing decisions
- ⚠️ Destructive/risky operations
- 🎯 Priority/triage decisions
- 💡 Creative/strategic forks
- 📋 Workflow/process choices
- 🔐 Credential/security decisions
Context block
1-3 lines maximum. The user should understand the decision in under 5 seconds.
Button/option labels
Format: Action verb — brief qualifier
- ✅ "Merge — combine with existing page"
- ✅ "Create new — separate meeting page"
- ❌ "Option 1"
- ❌ "Click here to merge the content into the existing brain page"
Examples
Cold-start phase gate
Filing decision
Destructive operation
Integration With Other Skills
This pattern is used by:
- cold-start — phase gates for each import source
- ingest — routing decisions for ambiguous content
- enrich — merge vs create decisions for entity pages
- brain-ops — filing location decisions
- meeting-ingestion — where to file meeting notes
- archive-crawler — scan vs full ingestion gate
When building a new skill that needs user input at a decision point, reference this pattern rather than inventing a new one.
Anti-Patterns
- Continuing the turn after presenting choices. "While you decide, I'll start on..."
defeats the gate. Stop. Wait. The whole point is that the user controls what happens next.
- Picking a default and proceeding silently. If the question matters enough to ask,
it matters enough to wait. Silent defaults erode trust the next time you do ask.
- More than 4 options. Decision paralysis is real. Group, summarize, or split into
staged questions instead.
- No escape hatch. Every choice gate must let the user decline. "None of these"
/ "Skip" / "Cancel" is mandatory.
- Stacking multiple choice gates in one message. The user can only answer one
question per turn. Multi-question gates either get half-answered or dropped entirely.
- Cryptic option labels. "Option 1" forces re-reading the context. "Merge into
existing page" is self-explanatory.
- Asking about low-stakes decisions. If the wrong answer costs nothing, just pick
the best option and mention it. Reserve gates for forks where rework is expensive.
Output Format
The skill's "output" is the choice-gate message itself, structured as:
After emitting this, the skill stops the turn. No further tool calls, no preemptive action, no follow-up message until the user responds. The user's response triggers the next turn, where the calling skill branches on the chosen option.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ask-user/SKILL.md
Popularity
- Repository stars
- 143
- Repository forks
- 126
- 7-day trend score
- 25
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/inbrainfun/inbrain/ask-user)