Agent skill

Swarm

by ZaxbyHub in ZaxbyHub/opencode-swarm

Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate.

MITAuto-check passedAgent Workflows

Install Swarm

skills CLI
$ npx skills add ZaxbyHub/opencode-swarm --skill swarm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZaxbyHub/opencode-swarm swarm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZaxbyHub/opencode-swarm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/swarm .claude/skills/swarm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
swarm
GitHub stars
494
Token cost
~2.7k tokens
SKILL.md length
977 words
Files
1
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate.

  • Works in 4 steps: Parallel exploration and mapping for… → Parallel specialist review for disjoint… → Independent reviewer validation for… → …
  • Tasks that involve Multi-agent orchestration
  • SKILL.md covers Goal, What this mode changes, Quality policy and Default triage model, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Swarm is an agent skill from ZaxbyHub/opencode-swarm. Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate. Runtime adapters (.claude, .agents) add execution-specific notes and command wiring.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Multi-agent orchestration. The repository describes itself as: Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review. The licence is MIT.

When your agent uses it

  • Tasks that involve Multi-agent orchestration

Example prompts

  • “/swarm”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Parallel exploration and mapping for breadth
  2. Parallel specialist review for disjoint concerns
  3. Independent reviewer validation for findings that are high-risk, ambiguous, cross-file, or likely false-positive-prone
  4. Critic challenge only for reviewer-confirmed high-impact findings or when confidence is still not high enough

What it can do on your machine

Read from SKILL.md and the folder at commit b63a4bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Swarm loads about 2.7k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 977 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZaxbyHub/opencode-swarm at commit b63a4bd, republished under its MIT licence (© ZaxbyHub). 977 words, ~2,732 tokens.

Download SKILL.mdSave it as .claude/skills/swarm/SKILL.md (or your agent's skills folder).
name
swarm
description
Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate. Runtime adapters (.claude, .agents) add execution-specific notes and command wiring.
audience
swarm-plugin

Goal

Turn the host agent into a swarm-like orchestrator that prioritizes complete, evidence-backed results over elapsed time, token count, or dispatch count.

What this mode changes

When enabled, the agent should:

  • use parallel subagents aggressively for disjoint exploration, codebase mapping, and specialist review
  • separate candidate generation from validation
  • use independent reviewer and critic contexts that are explicitly skeptical and suspicious
  • avoid letting implementation and verification happen in the same context when verification quality would benefit from separation
  • keep quality as the only metric that matters
  • treat time pressure as nonexistent
  • preserve normal host-agent strengths: parallel subagents, scoped exploration, and fast synthesis
  • spend the deepest validation effort where it materially reduces ship risk, without using time, token, or dispatch cost to waive a required gate

Quality policy

Code quality and pre-ship defect detection are paramount. Elapsed time, token count, dispatch count, and perceived repository simplicity are never reasons to weaken a required workflow step. Parallelism is used to reduce wall-clock latency without reducing coverage or independence.

That means:

  • parallelize breadth aggressively
  • validate in depth selectively based on risk
  • run every reviewer or critic loop required by the active workflow; optional extra scrutiny may still be risk-targeted
  • spend the most time on correctness, security, edge cases, regressions, and claimed-vs-actual mismatches
  • keep low-risk nits cheap

Only explicitly optional workflow steps may be skipped. A required step remains required even when the architect predicts that it will find nothing. If a workflow step prevents real bugs from shipping, keep it even if it costs time.

Default triage model

Use this default escalation ladder for exploration, candidate findings, and read-only work:

  1. Parallel exploration and mapping for breadth
  2. Parallel specialist review for disjoint concerns
  3. Independent reviewer validation for findings that are high-risk, ambiguous, cross-file, or likely false-positive-prone
  4. Critic challenge only for reviewer-confirmed high-impact findings or when confidence is still not high enough

Do not use this risk ladder to weaken the mandatory implementation closeout gate below. Any task that edits code, tests, docs, package metadata, release notes, or skill files must still complete the implementation reviewer and final critic gates on the latest diff and evidence.

High-risk work includes:

  • auth, authz, permissions, identity, session handling
  • payments, billing, data mutation, destructive actions
  • dependency changes, install scripts, lockfile changes
  • public API changes, schema changes, migrations
  • concurrency, retries, state machines, caching, queueing
  • security-sensitive parsing, file access, subprocesses, secrets

Lower-risk read-only or answer-only work can use a lighter path if evidence is strong:

  • answering a question about existing code or docs
  • summarizing an already-reviewed diff without editing it
  • reading logs or test output and explaining the likely cause
  • checking whether a file or command exists without changing the worktree

Mandatory implementation closeout gate

For any swarm task that edits code, tests, docs, package metadata, release notes, or skill files, do not declare completion until all of these are true:

  1. Objective validation has run and the commands/results are recorded.
  2. A fresh independent implementation reviewer has reviewed the actual current diff and validation evidence.
  3. A separate critic has challenged the reviewer-approved current diff and evidence.
  4. Every NEEDS_REVISION, REJECTED, or BLOCKED reviewer/critic item was fixed with code, docs, or evidence and then re-reviewed.
  5. The latest edit is older than the latest reviewer approval and critic approval.
  6. Reviewer and critic verdicts are recorded in durable task artifacts. For issue-tracer work, use 08b-implementation-review.md and 09-final-critic.md; for other changed-work tasks, create or update task-local review artifacts unless the repo forbids artifacts.

Explorer findings, plan critics, passing tests, and self-review do not satisfy the implementation reviewer gate. If subagent delegation is available and the user/session has authorized swarm work, fallback self-review is not allowed. If no independent context is available, disclose that limitation explicitly and do not imply full swarm validation.

Any edit after reviewer or critic approval invalidates that approval. Re-run the affected reviewer/critic gate before final synthesis.

Show full SKILL.md (335 more words)Show less

Enablement steps

  1. Create the appropriate session directory if it does not exist.
  2. Create or overwrite the session swarm-mode contract file with the exact content below.
  3. Confirm that swarm mode is now enabled for this session.
  4. For the user's next complex task, follow the swarm-mode contract automatically unless the user disables it.

The session contract file is written to a runtime-specific session dir. Use the path that matches the host runtime:

RuntimeSession contract path
OpenCode.zcode/session/swarm-mode.md
Claude Code.claude/session/swarm-mode.md
Codex.codex/session/swarm-mode.md

Write this exact file:

md
# Swarm Mode Contract

Swarm mode is enabled for this session.

## Core principles
- Quality is the only success metric.
- There is no time pressure.
- There is no reward for finishing in fewer passes.
- Large tasks require more disciplined verification, not less.
- Use parallel subagents whenever scopes are disjoint and doing so does not reduce quality.
- Keep breadth, validation, and final challenge in separate contexts when possible.

## Role model
- Explorer role: fast, broad, cheap, suspicious mapper and candidate generator
- Reviewer role: independent validator of candidate findings, hyper-critical and skeptical
- Critic role: final challenger of reviewer-confirmed findings, hyper-suspicious and willing to overturn weak claims
- Main thread: architect/orchestrator that assigns scopes, persists state, and synthesizes only validated outputs

## Hard rules
- Explorer findings are candidate findings, not final findings.
- Candidate findings should be validated by an independent reviewer context before being treated as confirmed whenever the task is important enough to justify it.
- Reviewer should default to DISPROVED or UNVERIFIED unless the finding is actually supported by code evidence and, when relevant, runtime-aware verification.
- Critic should challenge reviewer-confirmed findings in small batches.
- For any task that edits code, tests, docs, package metadata, release notes, or skill files, final completion requires an independent implementation reviewer approval and a separate critic approval on the latest diff and evidence.
- Passing tests, explorer output, plan critique, and self-review do not satisfy the final implementation reviewer or critic gates when independent subagents are available.
- Any edit after reviewer or critic approval invalidates that approval; re-run the affected gate.
- A `NEEDS_REVISION`, `REJECTED`, or `BLOCKED` verdict blocks final completion until fixed and re-reviewed.
- If quality and speed conflict, quality wins.
- Do not batch more aggressively or skip validation because the repo is large.
- Premature completion is a failure state.

## Parallelism policy
Use parallel subagents for:
- repository mapping
- subsystem investigation
- test analysis
- security review
- performance review
- dependency review
- docs/release drift review
- candidate-finding validation when clusters are disjoint
- changed-area impact analysis
- implementation planning across disjoint modules

Do not parallelize tasks that edit the same files unless the workflow explicitly isolates them.
Parallelism is the default speed lever.
Use it aggressively wherever scopes are disjoint.
Serial work is for synthesis, conflict-prone edits, and final high-confidence validation.

## Default execution pattern for complex tasks
1. Explore and map in parallel.
2. Build a plan.
3. Implement in scoped units.
4. Validate with independent reviewer context.
5. Challenge changed-work completion with a separate critic context.
6. Synthesize only validated results.

## Anti-rationalization rules
Ignore these thoughts:
- "This is probably fine"
- "The broad reviewer is good enough"
- "I can save time by merging validation stages"
- "This repo is too large to review this carefully"
- "I should move on because this is taking too long"

If any of those appear, slow down and return to the workflow.

How to behave after activation

For subsequent complex tasks in this session:

  • load the orchestrating-subagents skill for agent-type/model/effort tiering, fan-out limits, and subagent prompt contracts
  • load the durable-session-state skill to persist plans, evidence, and reviewer/critic verdicts so gates survive long sessions and compaction
  • spawn subagents in parallel for disjoint scopes
  • use one or more reviewer subagents to validate findings from explorer subagents or to validate implementation quality
  • use critic subagents only after reviewer validation, not as the primary false-positive filter
  • synthesize outputs with explicit status labels such as candidate, confirmed, disproved, unverified, or pre-existing when useful
  • keep the main context clean by pushing reading-heavy work into subagents

Suggested subagent prompts

When you need an explorer-style subagent, tell it:

  • map the assigned scope quickly
  • find candidate issues only
  • be broad and suspicious
  • return exact file/line references
  • do not present findings as final truth

When you need a reviewer-style subagent, tell it:

  • validate candidate findings from another subagent
  • be hyper-critical and default to disbelief
  • actively look for mitigating context that disproves each candidate
  • use runtime-aware validation when safe and needed
  • classify each item as CONFIRMED, DISPROVED, UNVERIFIED, or PRE_EXISTING

When you need a critic-style subagent, tell it:

  • challenge reviewer-confirmed findings in small batches
  • look for overclaimed severity, weak evidence, missing sibling-file checks, and poor actionability
  • prefer removal over noisy weak inclusion

Notes

  • This skill defines the cross-agent swarm-mode behavior model. Runtime adapters (.claude, .agents) add execution-specific command wiring and agent notes.
  • It does not permanently change project behavior.

© ZaxbyHub, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/swarm of ZaxbyHub/opencode-swarm.

Open the folder on GitHubat commit b63a4bd

Compare with similar skills

Swarm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Swarm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swarm this skillZaxbyHub/opencode-swarm494—~2.7kAutomated safety check: PassMIT
Orca CLIstablyai/orca89k2 repos~593Automated safety check: PassMIT
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Paseo Committeegetpaseo/paseo20k1 repos~496Automated safety check: PassCustom licence
Mission Control Agent APIbuilderz-labs/mission-control6.3k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    89k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Paseo Committee

    getpaseo/paseo

    Forms a two-agent committee with contrasting profiles to analyze a stuck problem in parallel, reconcile their views and return a consensus plan without editing files.

    20k GitHub starsUsed in 1 repo~496 tokens
    Agent WorkflowsAuto-check passed
  • Mission Control Agent API

    builderz-labs/mission-control

    Teaches an agent to use the Mission Control dashboard API: register, send heartbeats, fetch assigned tasks, report progress and disconnect, with API key auth.

    6.3k GitHub stars~2.1k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed

More from ZaxbyHub/opencode-swarm

All 91 skills in this repo
  • Codebase Review Swarm

    ZaxbyHub/opencode-swarm

    Runs an evidence-gated, quote-grounded audit of a codebase for security, QA, accessibility, performance and more, and writes a verified report without changing source files.

    496 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Issue Tracer

    ZaxbyHub/opencode-swarm

    Drives a bug report from validation and root-cause tracing through a critic-reviewed plan, an approved minimal fix and a PR-ready closure, never merging without recorded human approval.

    496 GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Commit and PR Publishing for Codex

    ZaxbyHub/opencode-swarm

    Codex adapter for opencode-swarm that governs commits, pushes, draft PRs, PR body updates and CI closeout, deferring to the repo's canonical commit-pr protocol.

    496 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Durable Session State

    ZaxbyHub/opencode-swarm

    Keeps plans, decisions, evidence and reviewer verdicts in small files so long multi-phase tasks survive context compaction and session resumes.

    496 GitHub stars~896 tokensUpdated today
    Auto-check passed
  • Swarm PR Feedback Closer

    ZaxbyHub/opencode-swarm

    Ingests existing pull request feedback such as review comments and CI failures, verifies each claim, fixes confirmed issues and reports closure status for every item.

    496 GitHub stars~14k tokensUpdated today
    Auto-check passed
  • Swarm PR Subscribe

    ZaxbyHub/opencode-swarm

    Monitor a pull request after creation and act autonomously on pushed PR activity.

    496 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Swarm

What does Swarm do?

Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate. Swarm is an agent skill from ZaxbyHub/opencode-swarm. Cross-agent swarm-mode behavior model — a higher-rigor workflow using parallel investigation, independent reviewer validation, and critic challenge, plus the mandatory implementation closeout gate.

When should I use Swarm?

Swarm fits situations like: tasks that involve Multi-agent orchestration.

How do I install Swarm in Claude Code?

Run `npx skills add ZaxbyHub/opencode-swarm --skill swarm -a claude-code`. Or copy the skill folder (.opencode/skills/swarm in ZaxbyHub/opencode-swarm) into .claude/skills/swarm in your project. Claude Code loads it when a task matches its description.

How do I install Swarm in Codex?

Run `npx skills add ZaxbyHub/opencode-swarm --skill swarm -a codex`. Or copy the skill folder (.opencode/skills/swarm in ZaxbyHub/opencode-swarm) into .agents/skills/swarm in your project. Codex loads it when a task matches its description.

Can I use Swarm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZaxbyHub/opencode-swarm --skill swarm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swarm, .gemini/skills/swarm, .github/skills/swarm and .opencode/skills/swarm in your project.

What does Swarm need to run?

SKILL.md names no scripts, command-line tools or credentials: Swarm is instructions for the agent only.

Does Swarm access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Swarm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Swarm use?

Swarm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Swarm use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Swarm?

Skills that share tags, products or a category with Swarm: Orca CLI (stablyai/orca, 89k stars), Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars), O2 Review Loop (openobserve/openobserve, 22k stars) and Paseo Committee (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swarm?

ZaxbyHub (a GitHub organization) maintains it in ZaxbyHub/opencode-swarm, which has 494 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on October 10, 2026.

Source: ZaxbyHub/opencode-swarm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.