skills.rest
warpdotdev
warpdotdevOFFICIAL
Explore all skills by this author →
WebsiteGitHub

review-pr

Generate a machine-readable review.json from local PR diff and description files.

292|39|Updated Mar 17, 2026
Search Tags:#automation#git#security#pull-request#review-output#review-pr
One-click install
npx skills add https://github.com/warpdotdev/oz-for-oss --skill review-pr-warpdotdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/warpdotdev/oz-for-oss/tree/main/.agents/skills/review-pr
Command: npx skills add https://github.com/warpdotdev/oz-for-oss --skill review-pr-warpdotdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviewing PRs manually is time-consuming and error-prone; this skill automates generating structured feedback for PR diffs and descriptions into a machine-readable review.json.

Core Features & Use Cases

  • Generates a review.json from pr_diff.txt and pr_description.txt without posting to GitHub.
  • Validates against optional spec_context.md using local tooling to ensure spec compliance.
  • Integrates with repository-specific security review passes to fold findings into the review output.

Quick Start

Run the review-pr skill in the PR workspace to output review.json.

Frequently Asked Questions about review-pr

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

FAQPage Schema
How do I generate a machine-readable PR review locally?▼

To generate a machine-readable PR review locally, run the skill in your PR workspace. It processes local artifacts like pr_diff.txt and pr_description.txt to output a structured review.json without posting comments to GitHub.

Can I validate a pull request against a repository spec?▼

Yes, you can validate a pull request against a repository spec by providing an optional spec_context.md file. The skill uses repository-local scripts to resolve this spec context and checks the PR diff for compliance.

Does the review process include a security check pass?▼

The review process includes a security and quality check pass. It folds these security findings directly into the final machine-readable review.json output alongside the standard PR feedback.

What is the best way to automate pull request reviews without GitHub API access?▼

The best way to automate pull request reviews without GitHub API access is to process checked-out local PR artifacts. This skill generates a review.json file from pr_diff.txt and pr_description.txt entirely offline.

Do I need to post review comments to GitHub to get structured PR feedback?▼

You do not need to post review comments to GitHub to get structured PR feedback. The skill operates on local artifacts and emits a final JSON review file directly in your workspace.

What file formats do I need to prepare for automated PR review?▼

You need to prepare local text file formats like pr_diff.txt and pr_description.txt for automated PR review. You can also include an optional spec_context.md file for specification validation.

Related Skills

Explore More Software Engineering Skills→
89jobrien89jobrien

review-pr

Read pr_diff.txt and pr_description.txt to generate review.json.

Community
Intermediate
warpdotdevwarpdotdev
292

review-spec

Evaluate spec PRs and write structured feedback to review.json.

Official
Intermediate
cxnaivecxnaive

github-code-review

Review local git changes and GitHub pull requests with automated feedback.

Community
Advanced
bossjonesbossjones
1

pr-review

Automate GitHub pull request reviews with inline comments and structured JSON payloads.

Community
Advanced