pr-review-skill

pr-review-skill

AI-powered PR review pipeline for Claude Code. It turns 30-45 minute PR reviews into structured reviews with deep code analysis, provider-aware AI review triage, worktree-aware auto execution, fix-forward support, and educational developer feedback.

Killer Feature

The killer feature is automated PR review that combines direct code review with GitHub Copilot and CodeRabbit comment handling in one flow.

Use one command:

# --auto: receives a PR number, fetches the PR, and runs the full pipeline
# --review-source all: triages both GitHub Copilot and CodeRabbit comments if present
/pr-review --auto 161 --review-source all

What that pipeline gives you:

• fetch the PR directly from GitHub
• run independent deep code review on the actual diff
• triage GitHub Copilot and CodeRabbit comments together
• separate provider-specific feedback cleanly
• support fix-forward workflow with managed Round N records
• stop safely on repos with staged changes unless a clean worktree is prepared (unstaged modifications are OK)
• preview reply/resolve actions safely before any --live mutation

Direct code review remains the primary output. AI review triage is secondary.

• Team rollout note: TEAM-USAGE.md

Prerequisites

Tool	Version	Purpose
Claude Code	1.0.33+	Runtime
Git	2.x+	Diff analysis

GitHub CLI (required for auto mode, strongly recommended)

Install and authenticate gh to unlock the full pipeline: auto-fetch PRs, inspect Copilot / CodeRabbit review data, post review replies, and resolve threads:

brew install gh   # or see https://cli.github.com/
gh auth login

Scripts also use jq for JSON parsing:

brew install jq

Without gh, auto mode (--auto) and script-based features won't work. You can still run reviews manually by saving the PR content to a local markdown file and providing the path:

/pr-review path/to/saved-pr.md --quick

# Verify all prerequisites
claude --version
gh auth status
jq --version

Install

Option A: Plugin marketplace (recommended)

# In Claude Code:
/plugin marketplace add junyoung2015/pr-review-skill
/plugin install pr-review@pr-review-skill

Option B: Local plugin

git clone [email protected]:junyoung2015/pr-review-skill.git
claude --plugin-dir ./pr-review-skill

Update an existing install

If installed as a local plugin

Pull the latest repo changes, then reload plugins or restart Claude Code:

git pull
/reload-plugins

If installed via marketplace

Update the marketplace metadata first, then refresh the installed plugin in Claude Code:

/plugin marketplace update <marketplace-name>

Version changes in .claude-plugin/plugin.json and .claude-plugin/marketplace.json are what allow Claude Code to detect a new release.

Usage

Once installed, use /pr-review directly:

# Full review from a PR document
/pr-review docs/pr-for-review/[TICKET-ID] description.md

# Full review from GitHub with provider selection
/pr-review https://github.com/owner/repo/pull/161 --review-source copilot

# Quick review (skip AI triage entirely)
/pr-review docs/pr-for-review/[TICKET-ID] description.md --quick

# Mixed-provider review
/pr-review https://github.com/owner/repo/pull/161 --review-source all

# Auto mode: fetch, review, fix-forward, prepare artifacts, then stop unless --live is present
/pr-review --auto 123 --review-source all --repo-path /abs/path/to/repo --worktree auto

If Claude Code auto-triggers the skill from natural language, that also works. /pr-review is just the most reliable explicit entrypoint.

Per-Project Settings

Create .claude/pr-review.local.md in your project root to customize behavior per-project:

---
output_language: ko          # ko, en, ja
default_review_source: all   # all, coderabbit, copilot, none
default_repo_path: ""        # absolute path to target repo (avoids --repo-path every time)
quick_review_dimensions:     # which dimensions for --quick mode
  - bugs
  - architecture
  - react-typescript
  - error-handling
  - performance
fix_forward_exclusions:      # patterns fix-forward should never auto-modify
  - "**/migrations/**"
  - "Dockerfile"
  - ".github/workflows/**"
track_developer_profiles: true
---

This file is gitignored by default (.claude/*.local.md). CLI flags override settings.

Do not rely on /pr-review:pr-review for flag-heavy usage. The supported command entrypoint is /pr-review.

Modes