review-pr

Reviews pull requests by classifying changed files and spawning specialized subagent reviewers.

1|1|Updated Oct 3, 2021
One-click install
npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill review-pr-benjr70
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/benjr70/Smart-Smoker-V2/tree/main/.claude/skills/review-pr
Command: npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill review-pr-benjr70

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing pull requests in a multi-service codebase requires checking database schema safety, WebSocket event contracts, infrastructure changes, and test coverage all at once, which is easy to do inconsistently or incompletely by hand. ## Core Features & Use Cases - Change Classification: Categorizes changed files into review domains (DB safety, event contract, infrastructure, coverage, general) based on file patterns. - Parallel Specialized Reviewers: Spawns subagent reviewers in parallel, each guided by a domain-specific reviewer instruction file with project-specific rules. - Structured Risk Assessment: Aggregates findings into a review report with a LOW/MEDIUM/HIGH/CRITICAL risk level and recommended actions, optionally posted as a PR comment. - Use Case: A developer opens a PR touching a Mongoose schema and a Docker compose file; the skill triggers the DB safety and infrastructure reviewers plus the general reviewer, then produces a consolidated risk-rated review. ## Quick Start Ask the assistant to review PR 42, or run the review on the current branch's pull request.

Frequently Asked Questions about review-pr

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

FAQPage Schema
How do I review a pull request with specialized reviewers?

Provide a PR number or run it from a branch with an open PR. The skill fetches the diff with the GitHub CLI, classifies changed files into domains, and spawns parallel subagent reviewers whose findings are aggregated into one report.

What review domains does this pull request reviewer cover?

It covers five domains: database schema safety for Mongoose and DTO changes, WebSocket event contract consistency, infrastructure changes across Terraform, Ansible, Docker, and GitHub Actions, test coverage impact, and general code quality conventions.

Does the PR review require the GitHub CLI?

Yes, it uses the gh CLI to fetch PR metadata, changed file lists, and diffs, and optionally to post the review as a PR comment. The gh command must be authenticated against the repository.

How is the pull request risk level determined?

Risk is rated LOW through CRITICAL based on findings: schema modifications to existing fields or event name changes rate HIGH, while breaking schema changes, missing data migrations, or infrastructure security issues rate CRITICAL.

Can the review be posted back to the pull request?

Yes, after aggregating findings the skill asks whether to post the structured review as a PR comment using gh pr comment. Posting is optional and only happens with user confirmation.