github-pr-review

Post GitHub PR reviews with bundled inline comments via gh or curl.

134|67|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/OpenHands/skills --skill github-pr-review-openhands
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-pr-review
Source: https://github.com/OpenHands/skills/tree/main/skills/github-pr-review
Command: npx skills add https://github.com/OpenHands/skills --skill github-pr-review-openhands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates posting GitHub PR reviews by bundling all inline comments into a single review, reducing manual effort and ensuring consistent feedback.

Core Features & Use Cases

  • One-shot review: Post all inline comments in a single PR review using the GitHub CLI or API.
  • Priority labeling: Include priority labels (Critical, Important, Suggestion, Nit) in comments for clear triage.
  • Fallback support: If the gh CLI is unavailable, switch to a curl-based POST to submit the review.

Quick Start

Use the github-pr-review skill to post a PR review with all inline comments in a single API call. Example:

gh api
-X POST
repos/{owner}/{repo}/pulls/{pr_number}/reviews
-f commit_id='{commit_sha}'
-f event='COMMENT'
-f body='Brief 1-3 sentence summary.'
-f comments[][path]='path/to/file.py'
-F comments[][line]=42
-f comments[][side]='RIGHT'
-f comments[][body]='🟠 Important: Your comment here.'
-f comments[][path]='another/file.js'
-F comments[][line]=15
-f comments[][side]='RIGHT'
-f comments[][body]='🟡 Suggestion: Another comment.'

Fallback: If gh is unavailable, use curl to post the review: curl -X POST
-H "Authorization: token $GITHUB_TOKEN"
-H "Accept: application/vnd.github+json"
"https://api.github.com/repos/{owner}/{repo}/pulls/{pr_number}/reviews"
-d '{"commit_id": "{commit_sha}", "event": "COMMENT", "body": "Review summary.", "comments": [{"path": "file.py", "line": 42, "side": "RIGHT", "body": "Comment"}, {"path": "file.py", "start_line": 10, "line": 12, "side": "RIGHT", "body": "Multi-line"}]}'

Frequently Asked Questions about github-pr-review

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

FAQPage Schema
How do I post multiple inline comments in a single GitHub PR review?▼

Post multiple inline comments in a single GitHub PR review by bundling all path, line, side, and body fields into one review API call using the GitHub CLI or a curl fallback to reduce manual effort and ensure consistent feedback.

What is the best way to automate GitHub PR reviews with priority labels?▼

Automating GitHub PR reviews with priority labels involves including Critical, Important, Suggestion, or Nit tags in the comment body fields during a single consolidated API call, ensuring clear triage and consistent feedback across multi-file PRs.

Can I submit a PR review if the GitHub CLI is unavailable?▼

You can submit a PR review if the GitHub CLI is unavailable by using a curl-based POST request with your GITHUB_TOKEN to hit the repository reviews endpoint, passing the commit_id, event, body, and comments array as JSON payload.

Does the one-shot PR review method support multi-file PRs across repositories?▼

The one-shot PR review method fully supports multi-file PRs across repositories by accepting an array of comments featuring distinct path, line, side, and body fields, allowing you to post all inline comments in a single API call.

Do I need a GITHUB_TOKEN to post inline comments via the API?▼

You need a GITHUB_TOKEN to post inline comments via the API, especially when using the curl-based fallback method to authenticate the POST request to the GitHub repository pulls reviews endpoint.

Why does this approach enforce one review per PR?▼

This approach enforces one review per PR to bundle all inline comments into a single consolidated review API call, which reduces manual effort, avoids fragmented feedback, and ensures clear triage with priority labels across multi-file PRs.