swarm

Orchestrate parallel worktree agents to open stacked GitHub PRs in dependency order.

Updated Apr 17, 2026

Search Tags:#automation #worktrees #github #topology #pull-requests #parallelism #swarmkit

Ready to run

npx skills add https://github.com/smallorbit/smallorbit-plugins --skill swarm-smallorbit

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: swarm
Source: https://github.com/smallorbit/smallorbit-plugins/tree/main/plugins/swarmkit/skills/swarm
Command: npx skills add https://github.com/smallorbit/smallorbit-plugins --skill swarm-smallorbit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, git, and includes scripts (resource) components.

What problem does it solve?

The Swarm Skill orchestrates parallel worktree agents to operate on GitHub issues and open stacked PRs in dependency order, enabling scalable review workflows.

Core Features & Use Cases

Spawn parallel agents for issues with dependency-aware PR stacking
Automatically determine base branches and target PR bases for downstream work
Support one-shot mode for specific issues and loop mode to continuously swarm the board

Quick Start

Spawn parallel agents for GitHub issues and manage stacked PRs using swarmkit.

Frequently Asked Questions about swarm

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

FAQPage Schema

How do I spawn parallel agents for GitHub issues to open stacked pull requests?▼

Parallel worktree agents operate on GitHub issues and simultaneously open stacked pull requests in dependency order. The orchestration handles planning, dependency resolution, spawning, and PR creation to enable scalable review workflows.

How does dependency-aware PR stacking work when processing GitHub issues in parallel?▼

Dependency-aware PR stacking automatically determines base branches and targets downstream PR bases according to issue dependencies. This ensures parallel worktree agents open stacked pull requests in the correct sequential order for review.

Do I need git and gh installed to automate pull requests across multiple worktrees?▼

Yes, you need git, gh, and jq installed to automate pull requests across multiple worktrees. These dependencies provide the foundational command-line interfaces required for repository operations, GitHub API interactions, and JSON data parsing.

Can I continuously swarm a GitHub project board to automatically resolve new issues?▼

Yes, you can continuously swarm a GitHub project board using loop mode. This mode continuously operates parallel worktree agents on the board, compared to one-shot mode which targets specific issues for a single batch run.

What is the best way to manage GitHub issue planning and dependency resolution for parallel agents?▼

The best way to manage GitHub issue planning and dependency resolution for parallel agents is using dedicated scripts that address topology and dependency order. This approach automates base branch determination and PR verification for stacked pull requests.