swarm-pr-review · zaxbyhub — Claude Code skill: what it does, how to install
The swarm-pr-review skill for Claude Code and Codex is a thin adapter for swarm pull request reviews that delegates execution to the canonical workflow in .opencode.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a claude-codeWhat swarm-pr-review does
This skill acts as a minimal shim rather than a standalone review engine. It points the agent to ../../../.opencode/skills/swarm-pr-review/SKILL.md to prevent duplication while keeping drift checks intact across platforms.
Execution relies on runtime parallelism dispatched across a batch of exact six subagents. When an external controller is absent, the skill engages Profile B instead of reporting an error. In this mode, it spawns fresh-context subagents, keeps review lanes strictly read-only, and preserves the pull request publication contract.
Commit provenance is verified using git rev-parse --verify <full_pr_head_sha>^0 and git cat-file -t <full_pr_head_sha>. The adapter requires the underlying .opencode directory in the repository, as all review logic resides there.
What it helps with
- run a parallel pull request review across an exact-six agent batch
- verify exact git head commit provenance before initiating code analysis
- execute review tasks with fresh-context subagents when no controller exists
- preserve the PR publication contract without triggering blocked status
Example prompts for the agent
- Run swarm-pr-review on the active pull request branch
- Verify commit provenance and trigger swarm-pr-review for PR #42
- Execute swarm-pr-review in Profile B mode with isolated subagents
How to install swarm-pr-review
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a claude-code2Manually: put the files in place
~/.claude/skills/swarm-pr-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swarm-pr-review/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a codex2Manually: put the files in place
.agents/skills/swarm-pr-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a cursor2Manually: put the files in place
.cursor/skills/swarm-pr-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .agents/skills/swarm-pr-review2Manually: put the files in place
.github/skills/swarm-pr-review/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/swarm-pr-reviewManually: put the files in place
.devin/skills/swarm-pr-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about swarm-pr-review
How do I install swarm-pr-review in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a claude-code in your terminal.
What does swarm-pr-review do?
It bridges your agent runtime to the canonical .opencode workflow to run multi-agent code reviews on pull requests.
How does Profile B handle controller absence?
It runs fresh-context subagents in read-only lanes and avoids marking the review as BLOCKED merely because the controller is missing.
Source text
SKILL.md · MIT
--- name: swarm-pr-review description: > Thin adapter for the canonical swarm-pr-review skill. The authoritative workflow lives in .opencode and this file only preserves the mirror contract for Codex-side skill discovery. metadata: audience: swarm-plugin --- # Swarm PR Review Read and follow `../../../.opencode/skills/swarm-pr-review/SKILL.md` as the canonical workflow. ## Codex Execution Notes - This adapter is a thin shim only. - Keep the canonical workflow in `.opencode`; do not duplicate protocol text here. - Treat the runtime's parallel-execution capability as the path for one structured exact-six batch; a different dispatch path is not equivalent. - Treat controller absence as Profile B, not an error: use fresh-context subagents, preserve read-only workflow-lane handling and exact-head provenance, keep `output_ref` recovery intact, preserve the PR publication contract, and never report BLOCKED merely because the controller is absent or the only alternative would be a degraded review. - For exact-head provenance, verify the commit with `git rev-parse --verify <full_pr_head_sha>^0` and `git cat-file -t <full_pr_head_sha>`. - Preserve the canonical workflow reference above so drift checks can verify delegation.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Code review and refactoring →swarm-pr-review by other authors comes first.