diff --git a/skills/using-superpowers/references/gemini-tools.md b/skills/using-superpowers/references/gemini-tools.md index f8698033..91ef4049 100644 --- a/skills/using-superpowers/references/gemini-tools.md +++ b/skills/using-superpowers/references/gemini-tools.md @@ -14,11 +14,29 @@ Skills use Claude Code tool names. When you encounter these in a skill, use your | `Skill` tool (invoke a skill) | `activate_skill` | | `WebSearch` | `google_web_search` | | `WebFetch` | `web_fetch` | -| `Task` tool (dispatch subagent) | No equivalent — Gemini CLI does not support subagents | +| `Task` tool (dispatch subagent) | `@agent-name` (see [Subagent support](#subagent-support)) | -## No subagent support +## Subagent support -Gemini CLI has no equivalent to Claude Code's `Task` tool. Skills that rely on subagent dispatch (`subagent-driven-development`, `dispatching-parallel-agents`) will fall back to single-session execution via `executing-plans`. +Gemini CLI supports subagents natively via the `@` syntax. Use the built-in `@generalist` agent to dispatch any task — it has access to all tools and follows the prompt you provide. + +When a skill says to dispatch a named agent type, use `@generalist` with the full prompt from the skill's prompt template: + +| Skill instruction | Gemini CLI equivalent | +|-------------------|----------------------| +| `Task tool (superpowers:implementer)` | `@generalist` with the filled `implementer-prompt.md` template | +| `Task tool (superpowers:spec-reviewer)` | `@generalist` with the filled `spec-reviewer-prompt.md` template | +| `Task tool (superpowers:code-reviewer)` | `@code-reviewer` (bundled agent) or `@generalist` with the filled review prompt | +| `Task tool (superpowers:code-quality-reviewer)` | `@generalist` with the filled `code-quality-reviewer-prompt.md` template | +| `Task tool (general-purpose)` with inline prompt | `@generalist` with your inline prompt | + +### Prompt filling + +Skills provide prompt templates with placeholders like `{WHAT_WAS_IMPLEMENTED}` or `[FULL TEXT of task]`. Fill all placeholders and pass the complete prompt as the message to `@generalist`. The prompt template itself contains the agent's role, review criteria, and expected output format — `@generalist` will follow it. + +### Parallel dispatch + +Gemini CLI supports parallel subagent dispatch. When a skill asks you to dispatch multiple independent subagent tasks in parallel, request all of those `@generalist` or named subagent tasks together in the same prompt. Keep dependent tasks sequential, but do not serialize independent subagent tasks just to preserve a simpler history. ## Additional Gemini CLI tools