github-pr-review
Extract and review GitHub Pull Requests with comprehensive analysis
When & Why to Use This Skill
The GitHub PR Review skill automates the extraction and analysis of GitHub Pull Requests, providing a structured methodology for comprehensive code reviews. By fetching metadata, commits, comments, and diffs via the GitHub API, it helps developers identify issues in code quality, security, and testing, significantly accelerating the PR approval workflow and ensuring high standards of software engineering.
Use Cases
- Streamlining Peer Reviews: Automatically generate detailed summaries and initial findings for complex Pull Requests to save time for senior reviewers and focus on critical logic.
- Security and Compliance Auditing: Systematically analyze PR diffs for potential security vulnerabilities and ensure adherence to organizational coding standards and best practices.
- Centralized Review Documentation: Maintain a structured, searchable history of PR extractions and reviews within a local directory for future reference, team knowledge sharing, and audit trails.
- Developer Mentorship: Provide junior developers with consistent, high-quality feedback based on a structured review methodology to improve code quality across the team.
| name | github-pr-review |
|---|---|
| description | Extract and review GitHub Pull Requests with comprehensive analysis |
GitHub PR Review Skill
Purpose
This skill extracts comprehensive GitHub Pull Request data and provides a structured methodology for code review. It fetches PR metadata, commits, comments, reviews, file changes, and diffs via the GitHub API, then guides analysis across code quality, security, testing, and best practices.
When to Use
Use this skill when you need to:
- Review a GitHub Pull Request
- Extract detailed PR information for analysis
- Generate a comprehensive PR summary
- Provide structured code review feedback
Prerequisites
Required Tools
curl- for GitHub API requestsjq- for JSON parsinggit- for repository operations
Environment
GITHUB_TOKEN- GitHub personal access token (optional for public repos, required for private)
Usage
Via Agent (Recommended)
Use the pr-reviewer agent for context isolation:
/review-pr https://github.com/owner/repo/pull/123
Direct Skill Invocation
Follow the instructions in instructions.md:
- Run extraction:
$HOME/.claude/skills/github-pr-review/scripts/extract.sh \
--owner <owner> --repo <repo> --pr <number>
Read the generated
extract.mdfrom the output directoryApply the review methodology from
instructions.mdSave the review to
review.mdin the same directory
What Gets Extracted
| Data | Source |
|---|---|
| PR metadata | Title, author, URL, description |
| Commit history | All commits with SHA, title, description, author |
| Comments | General PR comments with timestamps |
| Review comments | Line-specific comments with file:line context |
| Reviews | Approval states (APPROVED, CHANGES_REQUESTED, etc.) |
| File changes | Diffs and full post-change content |
| Documentation links | Auto-detected based on file types |
Output
The skill creates a directory structure for each PR review:
$BRAIN_HOME/github-pr-reviews/{owner}/{repo}/pr-{number}/
├── extract.md # Raw PR data from GitHub API
└── review.md # Structured analysis with summary, findings, and verdict
This organization:
- Keeps all PR reviews in a central location
- Preserves review history for future reference
- Groups reviews by repository for easy navigation
Integration
- Agent:
agents/pr-reviewer.md- runs skill in isolated context - Command:
commands/review-pr.md- invokes the agent