review-pr

Reviews pull request diffs against codebase conventions and outputs a structured verdict.

1|Updated Jul 7, 2025
One-click install
npx skills add https://github.com/agility/nextjs-demo-site-2026 --skill review-pr-agility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/agility/nextjs-demo-site-2026/tree/main/.claude/skills/review-pr
Command: npx skills add https://github.com/agility/nextjs-demo-site-2026 --skill review-pr-agility

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing pull requests consistently is time-consuming, and reviewers often miss project-specific conventions like CMS data-fetching patterns, component registration, or inline-editing attributes. This Skill automates PR reviews against the exact standards of an Agility CMS Next.js codebase. ## Core Features & Use Cases - Automated PR Fetching: Retrieves the PR diff via the GitHub CLI (gh pr view / gh pr diff), either from a provided PR number/URL or the current branch. - Convention-Aware Review: Checks TypeScript safety, Agility CMS patterns (getContentItem(), referencename fetching, <AgilityPic>, renderHTML()), Next.js App Router conventions, Tailwind CSS v4 styling, and security issues. - Structured Verdict Output: Produces a standardized review with severity-rated issues (Critical/Major/Minor), a documentation check, and an APPROVE / REQUEST CHANGES / NEEDS DISCUSSION verdict. - Use Case: Before merging a teammate's branch that adds a new CMS module, run the review to confirm the component is registered in the agility-components index and uses proper inline-editing attributes. ## Quick Start Ask the assistant to review the pull request for the current branch, optionally providing a PR number or URL.

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 an AI assistant?

Provide a PR number or URL, or simply ask to review the current branch's PR. The Skill fetches the diff using the GitHub CLI and returns a structured review with strengths, severity-rated issues, suggestions, and a final verdict.

What does this PR review check for in a Next.js codebase?

It checks TypeScript type safety, server vs client component usage, App Router conventions, metadata and SEO patterns, and Tailwind CSS v4 styling with dark mode variants. It also flags security issues like hardcoded secrets and injection risks.

Does the review cover Agility CMS-specific patterns?

Yes. It verifies correct use of getContentItem() and getContentList(), nested content fetching by referencename, component registration in the agility-components index, AgilityPic for images, renderHTML() for rich text, and inline-editing data attributes.

Can I review a PR without providing a PR number?

Yes. If no PR number or URL is given, the Skill uses gh pr view to find the pull request associated with the current branch and reviews its diff automatically.

How are issues in the PR review severity rated?

Issues are rated Critical for security or data-loss risks, Major for bugs and significant pattern violations, and Minor for style issues and nitpicks. The review ends with an APPROVE, REQUEST CHANGES, or NEEDS DISCUSSION verdict.