pr-review

Fetch GitHub PR diffs, run code-quality checks, and post structured reviews.

21|5|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/aws-samples/sample-agent-greenhouse --skill pr-review-aws-samples
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-review
Source: https://github.com/aws-samples/sample-agent-greenhouse/tree/main/src/platform_agent/plato/skills/pr_review
Command: npx skills add https://github.com/aws-samples/sample-agent-greenhouse --skill pr-review-aws-samples

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual GitHub PR reviews are time-consuming and error-prone; this skill automates detection of code-quality issues and spec violations to streamline merges.

Core Features & Use Cases

  • Retrieve PR diffs and changed files to surface actionable issues
  • Enforce code-quality checks (bare except clauses, TODO without linked issue, hardcoded secrets, missing docstrings)
  • Optionally verify against a provided spec.md and post a structured review to GitHub

Quick Start

Run the pr-review skill on a GitHub repository with a specific PR to generate a structured verdict and summary.

Frequently Asked Questions about pr-review

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

FAQPage Schema
How do I automate GitHub PR reviews for code quality and spec compliance?

Automating GitHub PR reviews involves fetching diffs and changed files to run code-quality checks and optionally verify against a spec.md. This skill generates a structured verdict of APPROVE, REQUEST_CHANGES, or COMMENT with a concise summary of file-level issues to post back to GitHub.

What specific code-quality issues can I automatically detect in a GitHub PR diff?

Code-quality checks in a PR diff detect bare except clauses, TODO comments without linked issues, hardcoded secrets, and missing docstrings. Analyzing the changed files surfaces these actionable issues automatically before posting a structured review back to GitHub.

Can I enforce spec compliance by checking a PR against a provided spec.md file?

Spec compliance is enforced by optionally verifying the fetched PR diff against a provided spec.md file. The skill analyzes the changes and posts a structured review back to GitHub, producing a verdict and summary of any spec violations or file-level issues.

What is the best way to post a structured review verdict back to a GitHub PR?

The best way to post a structured review verdict back to a GitHub PR is to analyze the diff and changed files, run code-quality checks, and optionally verify spec compliance. This produces an APPROVE, REQUEST_CHANGES, or COMMENT verdict with a concise summary.

Does automated PR review work without setting up complex dependencies or components?

Automated PR review works without external dependencies or components. You run the skill on a GitHub repository with a specific PR to fetch diffs, run code-quality checks, and generate a structured verdict and summary without requiring additional setup.

Why should I use automated diff analysis instead of manual code review for my pull requests?

Automated diff analysis streamlines merges by detecting code-quality issues and spec violations that manual reviews often miss. It fetches the PR diff, runs targeted checks for bare except clauses and hardcoded secrets, and posts a structured verdict back to GitHub to save time.