pr-review

Reviews barwise pull requests and produces a verified merge recommendation with ranked findings.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/semantic-praxis/barwise --skill pr-review-semantic-praxis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-review
Source: https://github.com/semantic-praxis/barwise/tree/main/.claude/skills/pr-review
Command: npx skills add https://github.com/semantic-praxis/barwise --skill pr-review-semantic-praxis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing pull requests consumes scarce human attention, and shallow reviews either miss real defects or bury reviewers in noise. This Skill reviews a barwise PR the way the codebase demands: it verifies the PR body's claims instead of inferring them, checks the failure modes agent-authored changes actually exhibit, and hands the human a defensible recommendation with exactly what was and was not checked. ## Core Features & Use Cases - Claim verification: Ranks the PR body's claims, tests the load-bearing one first, re-runs every number behind its command, and watches new gates go red on a planted defect before trusting them. - Barwise-specific invariant checklist: Runs checklist.md, the invariants CI cannot check, grouped by what the diff touches (core changes, new types, copies, tests, specs, skills, dependencies). - Ranked, actionable findings: Each finding cites file and line, a concrete failure scenario, the authority it violates, and a fix, with CONFIRMED, PLAUSIBLE, and REFUTED states earned by evidence. - Use Case: Ask it to review PR #409 before merging. It reads the body as claims, checks out the head commit, re-runs the claimed test counts, applies the checklist groups that trigger, and returns a five-part review: recommendation, reading order with risk peak, cleared regions with their tests, ranked findings, and a non-empty Not checked section. ## Quick Start Review pull request #409 on this repository and tell me whether it is ready to merge, without posting anything to GitHub.

Frequently Asked Questions about pr-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a pull request before merging it?▼

Point the Skill at the PR number or diff. It reads the body as a set of claims, checks out the head commit, re-runs the commands behind every number, applies the barwise invariant checklist, and returns a recommendation with ranked findings and a Not checked section.

What does this PR review check that CI does not?▼

It runs checklist.md, the barwise invariants CI cannot check: closed sets typed as unions, failures exported to callers, copies without drift guards, tests never seen failing, and spec anchors re-verified against the code. Anything npm run ci:local reports is excluded by construction.

Can the review approve or merge a pull request?▼

No. The Skill recommends but never approves or merges; the merge decision stays with a human. It posts reviews as COMMENT or REQUEST_CHANGES via GitHub tools, and only when the review identity differs from the PR author.

How are review findings verified and ranked?▼

Each finding cites file and line, a concrete failure scenario, the authority violated, and a fix. States are earned: CONFIRMED means reproduced or shown by the line, PLAUSIBLE names a realistic trigger, and REFUTED requires the quoted line that makes it impossible.

What agent-authored failure modes does the review look for?▼

It checks for tests weakened until CI passes, ratchets silenced through baseline rows, scope drift beyond the spec workstream, changes with no stated intent, and instruction files treated as logic rather than documentation.