skills.rest
smallorbit
smallorbitCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/smallorbit/smallorbit-plugins --skill swarm-smallorbit
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
smallorbitsmallorbit

clean-worktrees

Delete non-main agent worktrees and orphaned worktree-agent- branches.

Community
Advanced
paultyngpaultyng
9

rebase-pr-chain

Rebase stacked GitHub pull requests in dependency order and verify mergeability.

Community
Intermediate
garochee33garochee33
3

pr-babysit

Monitor pull requests for CI failures, merge conflicts, and review feedback.

Community
Advanced
oldwinteroldwinter
5

linear-cli

Manage Linear issues, projects, and teams via command-line interface.

Community
Intermediate