pr-reviewer

Codex skill for persistent, branch-aware pull request reviews.

The skill helps Codex review only the current PR change, infer intent from branch and PR metadata, persist review attempts under pr-reviews/, reconcile repeat reviews, and produce actionable PR-ready comments.

Install

Codex Plugin Marketplace

Add this repository as a Codex plugin marketplace:

codex plugin marketplace add coderdeep11/pr-reviewer

Restart Codex after adding the marketplace so the bundled $pr-reviewer skill is discovered.

Direct Skill Install

Clone this repository into your Codex skills directory:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/coderdeep11/pr-reviewer.git "${CODEX_HOME:-$HOME/.codex}/skills/pr-reviewer"

Restart Codex so the skill is discovered.

Use

Ask Codex to invoke the skill explicitly:

Use $pr-reviewer to review the current branch against main.

You can also provide more context:

Use $pr-reviewer to review branch feature/billing-retry against origin/main. PR title: Retry failed invoice syncs.

Supported inputs include:

• PR URL or number
• PR title
• PR branch or head ref
• base branch
• commit range
• current branch

Review Artifacts

When used in a target repository, the skill creates review history under:

pr-reviews/

Commit or ignore that directory according to the target repository's policy. The history lets repeat reviews identify resolved, still-open, ignored, and newly introduced findings.

Local Eval Harness

This repo includes a local-only eval harness under evals/.

python3 evals/run_pr_reviewer_eval.py \
  --artifact-root .eval-runs/manual \
  --report-dir .eval-reports/manual \
  --reviewer-timeout-seconds 900 \
  --reviewer-command 'codex exec --sandbox workspace-write --add-dir "{skill_root}" "$(cat {prompt_file})"'

See evals/README.md for the fake-reviewer smoke flow, scenario list, report format, and artifact policy.

Update

Refresh an existing plugin marketplace install with:

codex plugin marketplace upgrade pr-reviewer-marketplace

Restart Codex after upgrading so the bundled $pr-reviewer skill is refreshed.

For a direct skill install, pull the cloned skill repo:

git -C "${CODEX_HOME:-$HOME/.codex}/skills/pr-reviewer" pull