Skip to content
cccskills
FreePublished on GitHub

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

The English summary is being prepared. Showing the original description.

Works withGitHub
See how to install

Files included (1)

  • SKILL.md2.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

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

SituationAction
Ralph exits non-zeroDisplay error output. Suggest re-running with RALPH_DIAGNOSTICS=1
Report file missingDisplay intermediate files that do exist (scope, verification, findings)
PR argument missingAsk the user for the PR number
PR argument unparseableAsk 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Guides implementation of code tasks using test-driven development in an Explore, Plan, Code, Commit workflow. Acts as a Technical Implementation Partner and TDD Coach — following existing patterns, avoiding over-engineering, and producing idiomatic, modern code.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Generates structured .code-task.md files from descriptions or PDD implementation plans. Auto-detects input type, creates properly formatted tasks with Given-When-Then acceptance criteria.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Use when testing Ralph's hat collection presets, validating preset configurations, or auditing the preset library for bugs and UX issues.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Lists all code tasks in the repository with their status, dates, and metadata. Useful for getting an overview of pending work or finding specific tasks.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

pdd

Free

Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

Browser automation via Playwriter (remorses) using persistent Chrome sessions and the full Playwright Page API.

The English summary is being prepared. Showing the original description.

mikeyobrien/ralph-orchestrator3.2KUpdated Oct 16, 2026

See all skills by mikeyobrien

Report a problem with this skill