swarm-pr-review · zaxbyhub, claude — Claude Code skill: what it does, how to install
swarm-pr-review is a Claude Code skill that connects the canonical .opencode workflow to PR review sessions.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a claude-codeWhat swarm-pr-review does
This adapter mirrors the canonical review workflow stored in .opencode/skills/swarm-pr-review/SKILL.md. It holds no duplicate protocol logic, keeping delegation intact for drift verification checks.
When session tooling provides swarm controller commands, it handles multi-lane reviews via dispatch_lanes_async, collect_lane_results, and retrieve_lane_output. Direct task execution is intentionally treated as non-equivalent to this path. If the controller is missing, the adapter runs Profile B instead of failing with a BLOCKED state. In Profile B, it falls back to native Agent and Task tools while honoring the PR output contract.
Commit provenance must be confirmed using git rev-parse --verify <full_pr_head_sha>^0 alongside git cat-file -t <full_pr_head_sha>. Without the canonical .opencode directory in place, this shim has no executable review instructions.
What it helps with
- Run orchestrated PR reviews across parallel execution lanes
- Verify exact commit head provenance via low-level Git commands
- Fall back to native Agent and Task subagents when controllers are absent
- Maintain a single canonical review protocol across multiple agent clients
Example prompts for the agent
- Review the open pull request using the swarm-pr-review workflow
- Verify the PR head commit with git rev-parse and start the review lanes
- Execute swarm-pr-review under Profile B using native subagent tools
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 .claude/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 .claude/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 to install swarm-pr-review in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill swarm-pr-review -a claude-code. The file installs directly into ~/.claude/skills/swarm-pr-review/SKILL.md.
What does swarm-pr-review do?
It acts as a lightweight discovery shim in Claude Code that points directly to the canonical review rules in .opencode.
What happens if swarm controller tools are missing in the session?
It switches into Profile B mode. The agent uses standard Agent and Task tools instead of raising a BLOCKED error.
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 Claude-side skill discovery. metadata: audience: swarm-plugin --- # Swarm PR Review Read and follow `../../../.opencode/skills/swarm-pr-review/SKILL.md` as the canonical workflow. ## Claude Code Execution Notes - This adapter is a thin shim only. - Keep the canonical workflow in `.opencode`; do not duplicate protocol text here. - Only if this session actually exposes the swarm controller tools, use `dispatch_lanes_async`, `collect_lane_results`, and `retrieve_lane_output`; direct-Task dispatch are not equivalent to that controller path. - If the controller is absent, treat that as Profile B, not an error: use the native `Agent`/`Task` subagent tool flow, keep the PR publication contract intact, and never report BLOCKED merely because the controller is unavailable. - 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.