github-pr-review

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"}]}'