diff --git a/skills/brainstorming/SKILL.md b/skills/brainstorming/SKILL.md index b0d52b2589..fa69c61c8c 100644 --- a/skills/brainstorming/SKILL.md +++ b/skills/brainstorming/SKILL.md @@ -70,6 +70,7 @@ digraph brainstorming { - For appropriately-scoped projects, ask questions one at a time to refine the idea - Prefer multiple choice questions when possible, but open-ended is fine too - Only one question per message - if a topic needs more exploration, break it into multiple questions +- **Present questions as plain conversational text — do not use structured-choice tools (e.g. `AskUserQuestion`).** Ask in the chat/terminal interface directly. - Focus on understanding: purpose, constraints, success criteria **Exploring approaches:** diff --git a/skills/using-superpowers/references/claude-code-tools.md b/skills/using-superpowers/references/claude-code-tools.md index 7ddd549aa7..20c56c496f 100644 --- a/skills/using-superpowers/references/claude-code-tools.md +++ b/skills/using-superpowers/references/claude-code-tools.md @@ -19,6 +19,7 @@ Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). | Multiple parallel dispatches | Multiple `Agent` calls in one response | | Task tracking ("create a todo", "mark complete") | `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`; `TodoWrite` in `claude -p` / Agent SDK unless `CLAUDE_CODE_ENABLE_TASKS=1` is set | | Background-process / subagent lifecycle (read output, cancel) | `TaskOutput`, `TaskStop` — these are distinct from the todo tools above and apply to running shells, agents, and remote sessions | +| **Ask the user a question / present multiple-choice options** | **Plain conversational text in the terminal — do NOT use `AskUserQuestion`.** Skills that say "ask one question at a time" or "prefer multiple choice" mean to type the question/options directly into the chat, not invoke a structured-choice tool. | ## Instructions file