review-spec

Name: review-spec
Availability: InStock
Author: Warp

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

292|39|Updated Mar 17, 2026

Search Tags:#review #diff #spec #comment #pull-request #review-json #security-review-spec

Ready to run

npx skills add https://github.com/warpdotdev/oz-for-oss --skill review-spec-warpdotdev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: review-spec
Source: https://github.com/warpdotdev/oz-for-oss/tree/main/.agents/skills/review-spec
Command: npx skills add https://github.com/warpdotdev/oz-for-oss --skill review-spec-warpdotdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review a spec or plan pull request and write the output to review.json for automated publishing workflows, avoiding direct GitHub posts.

Core Features & Use Cases

Assess spec completeness, clarity, feasibility, and alignment with the linked issue.
Generate a machine-readable review.json containing structured feedback suitable for automation.
Apply the repository's security-review-spec pass as a supplemental review step and fold findings into the same output.

Quick Start

Provide the PR diffs and description to the skill and it will generate a machine-readable review.json.

Frequently Asked Questions about review-spec

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

FAQPage Schema

How do I generate machine-readable feedback for a spec pull request?▼

Generate machine-readable feedback for a spec pull request by providing the PR diff and description text to produce a structured review.json file. This approach assesses spec completeness and feasibility while avoiding direct GitHub comment posts.

How do I automate pull request reviews without posting comments directly to GitHub?▼

Automate pull request reviews by generating a structured review.json file instead of posting comments directly to GitHub. This machine-readable output captures spec evaluation feedback suitable for downstream automated publishing workflows.

What inputs are required to evaluate a spec PR for automated review workflows?▼

Evaluating a spec PR requires pr_diff.txt and pr_description.txt as inputs to assess alignment with linked issues. The process then outputs a structured review.json file containing the evaluated feedback.

Can I fold security review findings into a structured pull request review JSON?▼

Fold security review findings into a structured pull request review JSON by applying the repository's security-review-spec pass. This supplemental step integrates security findings directly into the same machine-readable review.json output.

Does the spec review process work for any pull request or only PRs modifying specs?▼

The spec review process specifically applies to pull requests that modify the specs/ directory. It evaluates spec completeness, clarity, and feasibility to generate a targeted review.json output for those PRs.