PR Review Toolkit
A Claude Code plugin for comprehensive PR review workflow: execute reviews, integrate Gemini suggestions, and interactively resolve issues.
Latest: See CHANGELOG.md for release notes | Releases for downloads
Features
| Skill | Description |
|---|
| pr-review-and-document | Execute comprehensive PR review using opus model and post structured results as a PR comment |
| gemini-review-integrator | Integrate Gemini Code Assist suggestions into the existing PR review comment |
| pr-review-resolver | Interactively resolve PR review issues one by one (繁體中文) |
Prerequisites
- GitHub CLI (
gh) - authenticated and configured
- pr-review-toolkit plugin (official) - The agents used by pr-review-and-document skill
Install the official pr-review-toolkit plugin first:
# In Claude Code
/plugin marketplace add claude-plugins-official
/plugin install pr-review-toolkit
Installation
From Marketplace (Recommended)
In Claude Code:
/plugin marketplace add marxbiotech/pr-review-toolkit
/plugin install pr-review-toolkit
From Source
# Clone the repository
git clone https://github.com/marxbiotech/pr-review-toolkit.git
# In Claude Code, add the plugin
claude --plugin-dir /path/to/pr-review-toolkit
Codex Plugin / Skills (From Source)
This repository also includes a repo-scoped Codex marketplace at .agents/plugins/marketplace.json, a Codex plugin packaged under plugins/pr-review-toolkit/ (with manifest at plugins/pr-review-toolkit/.codex-plugin/plugin.json, skill definitions under plugins/pr-review-toolkit/codex/skills/, and the helper scripts under plugins/pr-review-toolkit/scripts/):
| Skill | Description |
|---|
| codex-review-pass | Run six read-only Codex review subagents in parallel and return one deduplicated review bundle |
| pr-review-and-document | Publish the Codex review bundle to the canonical PR review comment and .pr-review-cache/pr-{N}.json |
| gemini-review-integrator | Integrate Gemini Code Assist inline comments into the canonical PR review comment |
| pr-review-resolver | Interactively resolve unresolved PR review findings one by one in Traditional Chinese and coordinate fix decisions |
| codex-fix-worker | Resolver-managed worker that fixes one selected issue with bounded owned files and reports validation results |
Until public Codex marketplace distribution is finalized, install from source by cloning the repository and registering it as a local plugin marketplace in Codex. The current Codex plugin docs describe codex plugin marketplace add . for this workspace-scoped flow; run codex plugin --help against your installed version if the CLI has changed. The marketplace entry points at the packaged plugin directory ("./plugins/pr-review-toolkit"), and the manifest there points Codex at ./codex/skills/ (relative to that plugin root), so keep the repository layout intact:
git clone https://github.com/marxbiotech/pr-review-toolkit.git
cd pr-review-toolkit
jq empty .agents/plugins/marketplace.json plugins/pr-review-toolkit/.codex-plugin/plugin.json
# Then register this directory as a local plugin marketplace using the
# subcommand documented for your Codex version (currently expected to be
# `codex plugin marketplace add .`).
Set the toolkit root for Codex sessions that run these skills. For source installs, point it at the packaged plugin root:
export PR_REVIEW_TOOLKIT_ROOT=/path/to/pr-review-toolkit/plugins/pr-review-toolkit
Codex review is split into distinct responsibilities. codex-review-pass is read-only: it launches the six review subagents (code-reviewer, code-simplifier, silent-failure-hunter, type-design-analyzer, pr-test-analyzer, and comment-analyzer) and returns a normalized bundle. pr-review-and-document owns review publishing and writes that bundle through the shared ${PR_REVIEW_TOOLKIT_ROOT}/scripts/cache-*.sh helpers. gemini-review-integrator merges Gemini Code Assist feedback into that same canonical comment. pr-review-resolver is the interactive decision coordinator for unresolved findings and owns all resolver status updates. codex-fix-worker is resolver-managed only: it fixes exactly one selected issue with bounded owned files and never writes the review comment/cache directly.
Recommended persistent command approvals for ACP-driven Codex runs:
