skills.rest
devbasex
devbasexOFFICIAL
Explore all skills by this author →
GitHub

pr-review

Review GitHub PR diffs and post approve or request-changes verdicts with inline comments.

1|Updated Apr 21, 2026
Search Tags:#code review#pull request#github#gh cli#ai delegation#inline comments#self-review
One-click install
npx skills add https://github.com/devbasex/ai-plugins --skill pr-review-devbasex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-review
Source: https://github.com/devbasex/ai-plugins/tree/main/plugins/ndf/skills/pr-review
Command: npx skills add https://github.com/devbasex/ai-plugins --skill pr-review-devbasex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing pull requests consistently is hard: reviewers skip spec compliance checks, leave scattered comments, or forget to post a formal verdict. This Skill enforces a two-stage review (spec conformance first, then code quality) and posts structured inline comments plus an APPROVE or REQUEST_CHANGES verdict directly on the GitHub PR. ## Core Features & Use Cases - Two-stage review: First verifies acceptance criteria, domain invariants, and scope adherence; then checks code quality, security, performance, and test design. - Two modes: PR mode posts inline comments and a verdict via the GitHub Reviews API; --branch mode self-reviews local branch diffs before a PR exists. - External AI delegation: Optionally delegates the review to Codex or agy CLIs, which post the review themselves and return a JSON result summary with fallback posting. - Use Case: Before merging a feature branch, run the skill against PR 9352 to receive severity-tagged inline comments ([critical/security], [major/readability]) and a REQUEST_CHANGES verdict posted on the PR. ## Quick Start Ask the AI to review PR 9352 and post the verdict and inline comments on 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 GitHub PR and post inline comments with gh CLI?▼

Use the GitHub Reviews API via gh api to submit a review containing a body, an event (APPROVE or REQUEST_CHANGES), and a comments array with path, line, and side fields. Build the JSON payload with jq -n --arg so values are safely escaped.

How do I review a local branch before creating a pull request?▼

Run the skill with the --branch flag to diff against the base branch declared in .ndf/worktree.json or the origin HEAD. It produces a session-only report with spec-conformance findings and improvement suggestions without posting anything to GitHub.

Can I delegate a PR review to Codex or agy instead of Claude?▼

Yes, pass codex or agy as the second argument. The skill builds a review prompt, the external CLI assembles the Reviews API payload and posts it via gh api, then writes a JSON result summary that the main agent validates.

Why does GitHub reject REQUEST_CHANGES on my own pull request?▼

GitHub returns HTTP 422 because you cannot request changes on your own PR. The skill keeps the intent as REQUEST_CHANGES but downgrades the posted event to COMMENT and records posted_as in the result summary.

How does the skill avoid duplicate review comments on a PR?▼

Before posting, it fetches existing review comments via gh api repos/OWNER_REPO/pulls/PR/comments and compares path and line. Matching findings are skipped or converted into replies on the existing comment thread.

Related Skills

Explore More Software Engineering Skills→
sommiosommio
1

git-commit-push-pr

Convert local worktree changes into a GitHub pull request with adaptive descriptions.

Community
Advanced
butterflyskiesbutterflyskies
1

review-fix-loop

Automate iterative code reviews with fix-and-re-review loops until severity thresholds are met.

Official
Advanced
Open-PawsOpen-Paws
3

code-review

Automate layered code review for pull requests in CI pipelines.

Official
Advanced
adawadaw

fabric-hotfix

Automate urgent XS/S fixes through analysis, coding, testing, review, and merging.

Community
Advanced