1. Habit
  2. Skills
  3. Review PR skill
warpdotdev · 29K installs

Review PR skill
Runs by itself, on every new code change.

Every code change gets a checked review.

Install the Review PR skill and make it a habit: follow https://gethabit.dev/skills/warpdotdev/review-pr.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

29K installs628 starsMIT licenceSource on GitHub ↗

Review PR

by warpdotdev · 29K installs

The skill

Reviews a code change and writes notes on the exact lines.

Only when you ask.

Fewer bugs

Every code change gets a checked review. Fewer bugs reach your users.

↻ Runs by itselfon every new code change

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

pull request opened. Runs in GitHub Actions.

  • ↻ pull request opened
  • pull_request.opened, pull_request.synchronize

02

It checks its work

validator passes. If a check fails, it tries again.

  • ✓validate_review_json.py passes against pr_diff.txt
  • ✓review.json is valid JSON with verdict APPROVE or REJECT
  • ✓verdict matches the recommendation in body
  • ✓every inline comment points to an annotated diff line

03

It remembers

verdicts per PR. The next run reads it first: earlier verdicts and issue counts for this PR.

loops/pr-review-json-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleOne pull request per run, at most two validator retries.

  1. 01

    Load local guidance

    The agent looks for a review-pr-local companion skill and applies it if found.

  2. 02

    Read inputs

    It reads pr_diff.txt, pr_description.txt and spec_context.md when present.

  3. 03

    Add companion checks

    It applies security-review-pr and check-impl-against-spec when the repository provides them.

  4. 04

    Audit comments and tests

    It checks every changed comment and test one by one against repository conventions.

  5. 05

    Write review.json

    Findings get CRITICAL, IMPORTANT, SUGGESTION or NIT labels and exact diff lines.

  6. 06

    Validate

    It runs validate_review_json.py and fixes review.json until it passes.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Review PR skill helps.

Use it when

  • ✓ You run PR reviews in CI
  • ✓ You need machine-readable review output
  • ✓ You want suggestion blocks on exact lines

Skip it when

  • – You want the agent to post comments directly
  • – There is no annotated diff file

Questions

Review PR skill, answered.

Does it post to GitHub?

No. It only writes review.json; the workflow publishes it. gh pr review and gh api are off limits.

When is a nit allowed?

Only with a concrete suggestion block that replaces exactly the commented lines.

How do I install the Review PR skill?

Copy the prompt at the top into your agent. It installs the skill from warpdotdev/common-skills and sets up the habit. Or run npx skills add warpdotdev/common-skills --skill review-pr.

Is the Review PR skill free?

Yes. It is published under MIT. Habit is free too.

Review PR. Now as a habit.

Install the Review PR skill and make it a habit: follow https://gethabit.dev/skills/warpdotdev/review-pr.md

  • Free
  • No account
  • Undo in one line

All warpdotdev skills →More code skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by warpdotdev, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.