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.