Agent skill
review-pr
Use when asked to review a PR, run a code review loop, or invoke the ralph reviewer against a pull request number or GitHub URL
Install this agent skill to your Project
npx add-skill https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/review-pr
Metadata
Additional technical details for this skill
- internal
- YES
SKILL.md
Review PR
Run the ralph.reviewer.yml orchestration loop against a pull request. The loop checks out the PR in an isolated worktree, runs tests, reviews the diff, and produces a structured report.
Usage
/review-pr <PR number or URL>
Accepts: 207, #207, or https://github.com/.../pull/207
Execution
1. Parse the PR argument
Extract the PR number from the argument. Strip # prefix or extract from URL path.
2. Run the reviewer loop
ralph run -H ralph.reviewer.yml -p "Review PR #<N>"
Bash tool settings:
timeout: 600000(10 minutes)run_in_background: true
Use TaskOutput with block: true to wait for completion.
3. Display the report
Read and print .ralph/REVIEW-REPORT.md to the conversation.
If the report file doesn't exist (loop failed before the synthesizer hat), check for and display whatever intermediate files exist:
.ralph/review-scope.md— what was scoped.ralph/review-verification.md— test results.ralph/review-findings.md— review findings
4. Verify cleanup
Check that the review worktree was removed:
ls -d .worktrees/review-<N> 2>/dev/null
- If gone: cleanup succeeded, no action needed.
- If still present: warn the user but do NOT force-remove. Say what's there and let them decide.
Also note the presence of intermediate files (.ralph/review-scope.md, etc.) — they're useful for debugging but the user may want to clean them up later.
Error Handling
| Situation | Action |
|---|---|
| Ralph exits non-zero | Display error output. Suggest re-running with RALPH_DIAGNOSTICS=1 |
| Report file missing | Display intermediate files that do exist (scope, verification, findings) |
| PR argument missing | Ask the user for the PR number |
| PR argument unparseable | Ask the user to provide a bare number, #N, or full GitHub URL |
What This Skill Does NOT Do
- Does NOT validate the PR exists (the scoper hat handles that)
- Does NOT modify any source code (read-only review)
- Does NOT post comments to GitHub
- Does NOT own worktree cleanup (verifies only)
- Does NOT enable diagnostics by default
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
complex-test-skill
A directory-style test skill for smoke testing
tui-debug-in-pane
Use when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.
test-driven-development
Unified TDD skill with three input modes — from spec, from task, or from description. Enforces test-first development using repository patterns, with proptest guidance and backpressure integration.
tmux-terminal
Interactive terminal control via tmux for TUI apps, prompts, and long-running CLI workflows.
pr-demo
Use when creating animated demos (GIFs) for pull requests or documentation. Covers terminal recording with asciinema and conversion to GIF/SVG for GitHub embedding.
pdd
Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.
Didn't find tool you were looking for?