swarm

Fans one job out to parallel delegate workers for coverage, races, gauntlets, or judged arenas.

1|Updated Sep 10, 2026
One-click install
npx skills add https://github.com/blauwtje/exo --skill swarm-blauwtje
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarm
Source: https://github.com/blauwtje/exo/tree/main/skills/swarm
Command: npx skills add https://github.com/blauwtje/exo --skill swarm-blauwtje

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running parallel AI workers without fixed judging rules leads to biased picks, overlapping work, and reports that hide gaps. This Skill enforces a disciplined fan-out workflow where the done predicate, judging rule, and disjoint scopes are all written down before the first worker spawns. ## Core Features & Use Cases - Four swarm shapes: coverage splits a scope into slices, race runs one brief N times, gauntlet runs N distinct checks against one artifact, and arena has N candidates build the same thing for rubric-judged comparison. - Pre-committed judging: a frame file fixes the done predicate, worker slices, and rubric before results exist, and a separate read-only judge delegate scores arena candidates criterion by criterion. - Disjoint execution: each worker gets its own worktree or output file, pinned SHAs and measurement methods, and returns a one-line verdict while full detail goes to its own file. - Use Case: You want three independent implementations of a parser compared fairly. Invoke the arena shape, let three candidates build in separate worktrees, have an Opus judge score them against a fixed rubric, then graft the best parts into one design. ## Quick Start Invoke the swarm skill with a shape, a done predicate, and a worker count, for example by typing /exo:swarm arena "a retry wrapper for the HTTP client" 3.

Frequently Asked Questions about swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run parallel AI agents on one task?▼

Invoke the swarm skill with a shape, a done predicate, and a worker count N. It writes a frame file fixing the rules first, then dispatches N general-purpose delegates in one background message, each with its own slice, worktree, and output file.

What is the difference between coverage, race, gauntlet, and arena shapes?▼

Coverage splits a scope into slices so every part gets checked. Race runs one brief N times and picks by first pass, rank all, or best-of. Gauntlet runs N distinct checks against one artifact. Arena has N candidates build the same thing for rubric-judged comparison.

When should I not use a parallel worker swarm?▼

Do not use it for a plan's tasks, which the implementing skill fans out in waves, or for a single read-only lookup, which the exo:explorer agent answers. A swarm for work one delegate could do buys N reports and a merge for no gain.

How does the arena judge avoid bias when scoring candidates?▼

The rubric is fixed in the frame file before any candidate runs and never enters a candidate brief. The judge is a read-only delegate on the opposite model from the candidates, scores by label only, and every score needs file-and-line evidence.

What happens when a swarm worker drops out or misses its SHAs?▼

A result missing its named SHAs or method reruns once; a second miss is recorded as a gap and never counts as a pass. A dropout leaves N-1 workers, which is noted in the final report rather than hidden.