Skip to main content
skill CX Codex

swarm · zaxbyhub — Claude Code skill: what it does, how to install

Enables a rigorous swarm-style posture with parallel searches, visible plan updates, and dual review gates for code changes.

MIT ★ 539 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill swarm -a claude-code
Open on GitHub

What swarm does

The skill adapts swarm behavior patterns for Codex and Claude Code sessions without calling external OpenCode commands. The agent runs parallel local searches where safe, keeps a visible task checklist using update_plan, and provides brief status updates during lengthy operations.

Every change to code, tests, docs, or package metadata must pass strict exit criteria. Final sign-off requires objective validation data, reviewer approval on the latest diff, and separate sign-off from a critic. Edits after these approvals are strictly forbidden. Passing tests or self-review do not count as reviewer approval when subagent delegation is authorized.

Verdicts stay documented in repository files. Tasks tracking bugs use 08b-implementation-review.md and 09-final-critic.md, while other work uses task-local artifacts. The skill also recommends commands such as $swarm-implement and $swarm-pr-review for dedicated phases.

What it helps with

  • run parallel code searches across local repository files
  • track complex refactoring progress through update_plan
  • enforce two-tier reviews by a distinct reviewer and a critic
  • record approval logs in artifacts like 08b-implementation-review.md

Example prompts for the agent

  • Run in swarm mode and inspect the authentication module
  • Refactor this handler using update_plan and prepare critic artifacts
  • Implement the pending bug fix following the $swarm-implement posture

How to install swarm

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/swarm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/swarm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about swarm

How to install swarm in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill swarm -a claude-code in your terminal. The configuration installs to ~/.claude/skills/swarm/SKILL.md.

What does the swarm skill do?

It applies a high-rigor swarm workflow that enforces parallel exploration, transparent step tracking, and double-review approvals before accepting code changes.

What gates are required to complete code edits?

You need objective validation proof, reviewer approval on the exact diff, subsequent critic approval, zero unresolved blockers, and no code edits after sign-off.

Source text

SKILL.md · MIT
---
name: swarm
description: Codex adapter for enabling a higher-rigor swarm-like workflow in the current Codex thread. Use when the user asks for swarm mode, maximum quality, parallel investigation, extra review rigor, or a swarm-style approach without necessarily invoking the OpenCode Swarm plugin.
metadata:
  audience: swarm-plugin
---

# Swarm

Read `.opencode/skills/swarm/SKILL.md` for the source behavior model, then adapt it to Codex.

Codex-specific execution notes:

- Treat this as a workflow posture, not an instruction to call OpenCode `/swarm` commands.
- Use parallel local reads/searches where safe.
- Use `update_plan` for visible task tracking on substantial work.
- Add independent review pressure through `$qa-sweep`, `$swarm-pr-review`, or self-critic checks when subagents are unavailable.
- Keep the user looped in with short progress updates during longer work.
- For any task that edits code, tests, docs, package metadata, release notes, or skill files, final completion requires:
  1. objective validation evidence,
  2. independent implementation reviewer approval on the actual latest diff,
  3. separate critic approval after reviewer approval,
  4. no unresolved `NEEDS_REVISION`/`BLOCKED` items, and
  5. no edits after those approvals.
- Record reviewer and critic verdicts in durable task artifacts. For issue-tracer
  work, use `08b-implementation-review.md` and `09-final-critic.md`; otherwise
  use task-local review artifacts unless the repo forbids artifacts.
- Explorer subagents, a plan critic, passing tests, or self-review do not satisfy the final implementation-review gate when subagent delegation is available and swarm work is authorized.

For implementation tasks, prefer `$swarm-implement`; for fresh PR review, prefer
`$swarm-pr-review`; for known PR feedback closure, prefer
`$swarm-pr-feedback`; for bug tracing, prefer `$issue-tracer`.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for Agent setup: memory, context, orchestration →

swarm by other authors comes first.

swarm backnotprop A skill for Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, and OpenCode that fans out N parallel subagents, drains their results, and returns a single consolidated report. Triggered by /swarm or the phrase "swarm this" in chat. CX Codex +1 10,300installs swarm langchain-ai swarm fans out independent items across subagents in parallel and aggregates the results. Useful for batch file reviews, labeling, and data extraction. CX Codex +1 9,700installs swarm ZaxbyHub Swarm mode for the agent: parallel exploration, an independent reviewer, a critic, and a closeout gate that blocks completion until the diff passes. CX Codex +1 ★ 539repo stars swarm ZaxbyHub Enables a multi-agent swarm workflow in the active session, running parallel subagents, independent review validation, and critic checks. CX Codex +1 ★ 539repo stars dyad:swarm-pr-review dyad-sh The dyad:swarm-pr-review Claude Code skill launches three subagents for PR review: correctness, code health, and UX experts. They discuss findings and post a GitHub review with a merge verdict. CX Codex +1 ★ 22,348repo stars ds-swarm aicodeking Claude Code skill splits broad tasks across parallel workers and merges their verified outputs into a single report. Triggers on /ds-swarm during audits or multi-branch races. CX Codex +1 537installs swarm-advanced ruvnet swarm-advanced — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that brings multi-agent swarm patterns to your workflow. Coordinates parallel research, development, and testing across specialized agents. CX Codex +1 1,200installs agent-swarm-deployer OneWave-AI agent-swarm-deployer deploys parallel sub-agent swarms for heavy data jobs like bulk document summarization, dataset processing, and multi-record content generation. CX Codex +1 247installs oss-contributor-swarm niveshdandyan oss-contributor-swarm deploys an autonomous 9-agent swarm to discover simple GitHub issues, write fixes, and submit pull requests. CX Codex +1 ★ 138repo stars swarm-issue ruvnet swarm-issue is a Claude Code command that connects GitHub Issues to swarm work by splitting tasks into subtasks, suggesting agents, and tracking progress. It supports workflows managed through GitHub Issues. CX Codex +1 ★ 850repo stars

From the same set121

The whole set →
run-affected-test-file-in-isolation-and-in-co-run-with-its-test- run-affected-test-file-in-isolation-and-in-co-run-with-its-test- is a Claude Code skill that makes the agent run tests in isolation and with sibling files after mock cleanup changes. CX Codex +1 ★ 539repo stars update-or-delete-tests-that-assert-intentionally-removed-behavio update-or-delete-tests-that-assert-intentionally-removed-behavio is a Claude Code skill for revising or removing tests of deliberately removed behavior. It applies to code changes that retire a code path. CX Codex +1 ★ 539repo stars use-internals-di-seam-pattern-for-test-injectable-functions use-internals-di-seam-pattern-for-test-injectable-functions is a Claude Code skill that uses _internals as a DI seam and checks mock isolation in combined Bun test runs. CX Codex +1 ★ 539repo stars worktree-retry-cleanup worktree-retry-cleanup is a Claude Code skill that cleans up a swarm worktree lane before a task is dispatched again. CX Codex +1 ★ 539repo stars research-first The research-first skill checks current documentation and discussions before tracing code when an issue depends on an external framework, tool, or platform. For repo-local questions, it searches the repository instead. CX Codex +1 ★ 539repo stars swarm-pr-subscribe swarm-pr-subscribe monitors open pull requests, triages incoming review comments or CI failures, and applies safe fixes until merge. CX Codex +1 ★ 539repo stars swarm-ci-monitor The swarm-ci-monitor skill monitors CI for an approved, reviewed PR, investigates failures, and works through fixes until checks pass. It can then merge the PR after a final review of its state. CX Codex +1 ★ 539repo stars commit-pr commit-pr — a checklist the agent must clear before it commits, pushes or opens a PR. Built for the case where an AI agent publishes the branch, not a person. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open