swarm

Orchestrate a multi-agent workflow from idea to pull request.

4|1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/MaxGzLi/claudeorc --skill swarm-maxgzli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swarm
Source: https://github.com/MaxGzLi/claudeorc/tree/main/skills/swarm
Command: npx skills add https://github.com/MaxGzLi/claudeorc --skill swarm-maxgzli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Swarm removes the manual overhead of turning a raw idea into a reviewed, tested pull request by orchestrating an end-to-end, multi-agent workflow that handles specification, planning, parallel implementation, review, knowledge extraction, and PR delivery.

Core Features & Use Cases

  • Interactive PM specification: Guided clarifying questions, scope proposals, and a written spec saved to docs/specs/YYYY-MM-DD-<topic>.md, requiring explicit user confirmation before automated phases.
  • Automated parallel planning: Dispatches Research, Codebase, and Docs agents in parallel to produce a merged implementation plan saved to docs/plans/YYYY-MM-DD-<topic>.md.
  • Isolated parallel work and test gating: Runs worker agents in isolated worktrees, executes batches with retries, merges changes, runs tests after each batch, and collects abnormal reports for later knowledge extraction.
  • Integration review and auto-fix: Runs an integration agent against the combined diff to auto-fix P1 issues and surface P2/P3 notes.
  • Ship flow with dual reviews and controlled merge: Creates a PR, runs tests, posts dual-agent reviews as comments, counts critical issues, and requires explicit user confirmation to merge.
  • Use case: Start a new feature or small project and let Swarm create the spec, plan tasks, run parallel worker agents, validate integration, extract learnings, and open the PR for human-approved merge.

Quick Start

Use the swarm skill by invoking /swarm followed by a one-sentence idea to start the interactive PM session and automated pipeline.

Frequently Asked Questions about swarm

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

FAQPage Schema
How do I automate turning a feature idea into a reviewed pull request?

To automate turning a feature idea into a reviewed pull request, you need a multi-agent orchestration workflow that handles specification, parallel implementation, testing, and PR delivery. Swarm orchestrates this end-to-end pipeline with interactive PM input and dual reviews.

What is multi-agent orchestration for parallel code implementation?

Multi-agent orchestration for parallel code implementation is the process of dispatching worker agents in isolated worktrees to execute tasks simultaneously. It involves running test-gated batches, merging changes, and performing integration reviews to auto-fix critical issues before delivery.

How do I start an automated multi-agent workflow for a new project?

To start an automated multi-agent workflow for a new project, invoke the swarm skill with a one-sentence idea. This initiates an interactive PM session that generates a written spec requiring explicit confirmation before the automated planning and implementation phases begin.

Does automated agent orchestration support branch isolation and test gating?

Yes, automated agent orchestration supports branch isolation and test gating. The workflow runs worker agents in isolated git worktrees, executes batches with retries, merges changes, runs tests after each batch, and collects abnormal reports for knowledge extraction.

How does automated integration review handle code issues before merging?

Automated integration review handles code issues by running an integration agent against the combined diff. It auto-fixes P1 critical issues and surfaces P2/P3 notes as comments, requiring explicit user approval before executing the final PR merge.

When should I use multi-agent orchestration for software development?

You should use multi-agent orchestration for software development when starting a new feature or small project that requires interactive PM specification, parallel research, test-gated worker agents, and automated PR creation with dual reviews and human-approved merge control.