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 

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 #"

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:

1. .ralph/review-scope.md — what was scoped
2. .ralph/review-verification.md — test results
3. .ralph/review-findings.md — review findings

4. Verify cleanup

Check that the review worktree was removed:

ls -d .worktrees/review- 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

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