swarm
Fan out parallel subagents over slices of a task, or race them on the same brief, then aggregate one report. Use when the user asks to swarm something, or when a skill calls for parallel coverage, races, gauntlets or exploration.
How do I install this agent skill?
npx skills add https://github.com/overextended/skills --skill swarmIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill orchestrates multiple subagents to perform tasks in parallel and aggregates their results into a single report. It uses local configuration files and standard version control commands to manage the environment. A surface for indirect prompt injection exists due to the aggregation of outputs from multiple subagents, although the skill includes instructions to consolidate rather than verbatim dump the content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Swarm
Fan out N parallel workers. They may cover separate slices, race the same brief, or mix both. You wait, aggregate, and return one report.
Start
Open a task list (your harness's task tool, or a checklist file at ~/.local/state/ox/checklists/<repo>-<branch>.md when it has none) with one entry per phase before launching anything.
- Frame
- Fan out
- Aggregate
- Report
Phase A: Frame
- State the done predicate and the artifact or report the swarm must return.
- Choose the shape. Partition into slices, race N workers on identical briefs, or mix both. For a race or mixed shape, declare
first pass,rank all, orbest-ofbefore spawning. - Set N from the user or derive it from the shape. N is total workers, not a concurrency limit.
- Pick the workers' role from what they do:
implementfor workers that write code,explorefor read-only search and coverage,reviewfor workers that verify or review. Use that role's line of~/.config/ox/models.md: pass its model and effort to your subagent tool. If the line isinherit, is missing, or the file's# harnessline names a different harness, omit both so the workers run on your model; if the file is missing, also suggest the user run/setup-ox models. If the tool rejects an entry, use the closest model it lists and say so. For a model race, take each arm's model from thepanelline and name it up front. - Give each worker its own writable output when it writes. When workers verify commits, each brief names the exact SHAs and the method, and the worker records both in its result.
Phase B: Fan out
Start all N workers at once, each named for its slice or race arm. Workers share your checkout, so parallel writers there own disjoint files and run no git commands. A worker that needs its own tree or branch gets a git worktree: commit first, because uncommitted edits do not reach a new worktree, then run git worktree add <path> -b <new branch> <commit or branch> and give the worker that absolute path as the only place it may write. One writer per worktree or branch. In T3 Code, a t3_thread_launch thread with a worktree workspaceStrategy does the same and binds the thread to it.
Every brief stands alone. Include the goal, scope, exact slice or race arm, how to verify, and what to report. Reports use PASS, ISSUES, or BLOCKED with evidence. A worker that can prove a defect reports ISSUES and lists every issue it can prove, not only the first.
Wait for every worker to finish. If a worker drops out, proceed with N-1 and note it.
Phase C: Aggregate
Read the terminal results. Drop a result that does not record the SHAs and method its brief names, and respawn that worker once. After a second miss, record a gap. A gap does not count as a pass. For coverage, every required slice needs a result. For a race, apply the selection rule declared up front. Do not paste raw worker dumps.
Keep a compact result table, one-line evidenced issues, and explicit gaps or dropouts. Remove each worker's worktree (git worktree remove <path>) once its result is merged or discarded.
Phase D: Report
Return one consolidated report with the table, issue one-liners, gaps or dropouts, and the race rule when used.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/overextended/skills/swarm">View swarm on skillZs</a>