swarm

Spawn isolated agents for parallel task execution with retries.

418|40|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/boshu2/agentops --skill swarm-boshu2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swarm
Source: https://github.com/boshu2/agentops/tree/main/skills/swarm
Command: npx skills add https://github.com/boshu2/agentops --skill swarm-boshu2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill orchestrates parallel autonomous workers by spawning isolated agents with fresh context for each task, enabling scalable execution of multiple beads or issues in parallel.

Core Features & Use Cases

  • Local mode: Claude-native task tooling with fast background workers
  • Distributed mode: tmux sessions + Agent Mail for persistent, isolated workers
  • Wave-based execution: spawn a new team per wave to ensure fresh context
  • Pre-assigned tasks: mayor assigns tasks before spawning to avoid race conditions
  • Retry and validation: workers can report progress and issues; validation checks gate completion

Quick Start

To start a wave, run /swarm. For a distributed setup, ensure the environment supports tmux and Agent Mail, then run /swarm --mode=distributed. See references for deeper workflow details.

Frequently Asked Questions about swarm

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

FAQPage Schema
How do I execute parallel tasks with Claude agents to speed up workflow completion?

Parallel task execution with Claude agents is achieved by spawning isolated workers with fresh context for each task, enabling scalable completion of multiple issues simultaneously. The skill orchestrates these agents using native coordination primitives and optional validation scripts.

What is wave-based task orchestration and how does it prevent race conditions?

Wave-based task orchestration spawns a new team per execution wave to ensure fresh context. Pre-assigned tasks are distributed by a mayor before spawning, which prevents race conditions and enables deterministic work across parallel agents.

Do I need tmux and Agent Mail to run distributed parallel agent orchestration?

Distributed parallel agent orchestration requires tmux and Agent Mail to support persistent, isolated workers. Local mode does not need these dependencies and instead relies on Claude-native task tooling with fast background workers.

How do I set up local mode for spawning parallel autonomous workers?

To set up local mode for spawning parallel autonomous workers, run the /swarm command. Local mode uses Claude-native task tooling with fast background workers, requiring no additional environment setup beyond the base Claude integration.

How are task validation and automated retries handled during parallel execution?

Task validation and automated retries are handled by allowing workers to report progress and issues during parallel execution. Validation checks gate the completion of tasks, ensuring deterministic work before a wave is finalized.

When should I avoid using isolated agent spawning for parallel workflow execution?

You should avoid using isolated agent spawning if your workflow requires shared context between tasks, as each agent operates with a fresh context. Additionally, distributed mode is unsuitable if your environment lacks tmux and Agent Mail support.