/gemini-swarm

name: gemini-swarm
description: Use BEFORE writing or editing code, tests, docs, or other content yourself — whenever the writing spans more than one file or more than ~20 lines. Delegating the writing to Gemini sessions via the agy (Antigravity) CLI is the default; you orchestrate. Also use when the user asks to swarm/fan out/parallelize work across Gemini or invokes /gemini-swarm. Triggers include implementing a feature, scaffolding or creating files, refactors, migrations, bulk edits, boilerplate, test suites, documentation, and multi-topic research. Skip only for trivial edits (a few lines in one file) or when the agy CLI is unavailable.

gemini-swarm

You are the **orchestrator**: you plan, decompose, route, and review. `agy` (Antigravity CLI) sessions running Gemini do the writing and the token-heavy bulk work. **Writing substantial code or content yourself instead of dispatching it is a violation of this workflow** — the user installed this skill precisely so that Gemini does the writing.

Verified against agy **1.0.15**. Re-check `agy --help` if flags seem wrong — this CLI changes fast.

Delegate by default

Before you write anything, apply this rule:

• Writing work that spans **more than one file or more than ~20 lines** →

dispatch it to Gemini via this skill. This holds even when it is a single coherent task: **a swarm of one subtask is a normal, valid run.** Parallel fan-out is an optimization, not a precondition.

• Trivial edits (a few lines in one file), pure planning/review, and answers

that need no artifacts → do them yourself.

• You still own everything around the writing: decomposition, prompts, model

routing, integration, verification, and the final report.

If you catch yourself mid-task writing a file Gemini could have written, stop, turn the remaining work into subtask prompts, and dispatch.

| Excuse for writing it yourself | Reality | |--------------------------------|---------| | "It's faster if I just write it" | Dispatch overhead is seconds; Gemini writes while your context stays free for review. | | "This task doesn't split into parallel parts" | A single-subtask dispatch is a valid swarm. Splitting is optional. | | "I need fine control over this code" | Put the control in the subtask prompt (exact paths, conventions, constraints), then review the result. | | "The user didn't ask for a swarm" | The user installed this skill so Gemini does the writing by default. Explicit invocation is not required. | | "I'm already halfway through writing it" | Sunk cost. Dispatch the remaining files. |

Step 0 — Preflight

1. `command -v agy` — if missing, stop and tell the user to install the Antigravity CLI. 2. Locate the dispatcher script, in this order:

• `${CLAUDE_PLUGIN_ROOT}/scripts/dispatch.sh` (plugin install)
• `scripts/dispatch.sh` next to this SKILL.md (standalone skill install)

Step 1 — Resolve the autonomy mode

The `/gemini-swarm` command (or the user directly) supplies one of three modes. If none was given, use `default`.

| Mode | Dispatch flag | Meaning | |------|---------------|---------| | `default` | mirror the host | If you (the host agent) are currently running with auto-accepted/bypassed permissions, use `--auto`. If your own edits require user review, use `--request`. | | `auto` | `--auto` | agy jobs run with `--dangerously-skip-permissions --sandbox` — full autonomy inside agy's terminal-restricted sandbox. | | `request` | `--request` | agy jobs never skip permissions; agy's configured `toolPermission` policy (`request-review`) governs gated tool calls. |

Never ask the user to pick a mode mid-run; resolve it yourself from the rule above.

Step 2 — Decompose the task

Split the task into **independent** subtasks:

• No two subtasks may write the same file or depend on each other's output.

Prefer splits along existing boundaries: different files, modules, directories, or research topics.

• If a task has a genuinely sequential core, keep that core for yourself and

swarm only the independent parts.

• Each subtask prompt must be **fully self-contained**. The Gemini sessions

share nothing — no conversation history, no knowledge of the other subtasks. Include in every prompt: the goal, the exact file paths to read/write, relevant constraints/conventions, and the expected output format.

• For write tasks, tell each subtask exactly which files it owns and to touch

nothing else. End each prompt with: "When done, print a line starting with `TOUCHED:` listing every file you created or modified, then a one-paragraph summary of what you did."

• Typical fan-out is 1–10 subtasks. One subtask is fine when the task is a

single coherent unit — dispatch it anyway rather than writing it yourself. Do not throttle or batch: quota is not a constraint, and all subtasks launch concurrently.

Step 3 — Route a model per subtask

Read the [model catalog](references/models.md), then choose a profile per subtask automatically — never ask the user which model:

• `flash-high` for all tasks, including reasoning-heavy or ambiguous work,

architecture, debugging, refactoring, and plain bulk work.

• Do not route to Pro or lower thinking levels. Follow the catalog’s policy

if the configured model is unavailable.

Copy the profile's exact `agy` model name from the catalog into the `MODEL:` header. The catalog is the single source of truth; never infer or hard-code a version elsewhere in this skill.

Step 4 — Write the subtask files

Create one prompt file per subtask in a temp directory (e.g. `$(mktemp -d)/01-slug.prompt.md`). Format — first line is a model header, then a blank line, then the prompt:

MODEL: <exact agy model name from references/models.md>

Summarize the public API of src/parser/ ...

Name files `NN-short-slug.prompt.md`; the basename (minus `.prompt.md`) becomes the subtask name in logs.

Step 5 — Dispatch (always parallel)

**If the `gemini-dispatcher` subagent is available** (plugin