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

review-spec

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
One-click install
npx skills add https://github.com/warpdotdev/oz-for-oss --skill review-spec-warpdotdev
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
Terry-MaoTerry-Mao
144

review-spec

Review GitHub pull request spec documents and generate review.json output.

Community
Advanced
sync-dev-orgsync-dev-org

sdd-publish-setup

Generate GitHub Actions workflows for publishing Python, TypeScript, and Rust packages.

Official
Advanced
warpdotdevwarpdotdev
292

review-pr

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

Official
Advanced
Dev10x-GuruDev10x-Guru
7

Dev10x:gh-pr-review

Automate GitHub pull request reviews with inline comments and workflow checks.

Official
Advanced