Our review

Inspects GitHub repositories, pull requests, issues, and workflows using the GitHub CLI.

Strengths

Read-only by default, safe for inspection
Integrates with Claude Code's bash tool for quick commands
Covers code reviews, CI checks, and repo details

Limitations

Requires gh CLI installed and authenticated
Limited to read-only operations; no creation or modification
May not cover all GitHub API endpoints

When to use it

When you need to review code or gather context from GitHub repositories without making changes.

When not to use it

When you need to create, merge, or modify GitHub resources, as those require explicit user permission.

Examples

View PR details

View the details of pull request #123 in this repository, including title, body, author, and latest commits.

List open PRs with status

List all open pull requests in this repository and show their status and CI check results.

Review PR diff and comments

Show me the diff for the current pull request and any review comments.

name: github description: Use when interacting with GitHub repositories, branches, or PRs. Automatically triggered for PR viewing, code review, and repo inspection tasks. allowed-tools:

Read
Grep
Glob
Bash(gh pr view:*)
Bash(gh pr list:*)
Bash(gh pr status:*)
Bash(gh pr checks:*)
Bash(gh pr diff:*)
Bash(gh api:*)
Bash(gh repo view:*)
Bash(gh issue view:*)
Bash(gh issue list:*)
Bash(gh run view:*)
Bash(gh run list:*)
Bash(gh workflow view:*)
Bash(gh workflow list:*)
Bash(gh browse:*)
Bash(gh status:*)

GitHub Skill

Use the GitHub CLI (gh) for viewing and inspecting GitHub resources. This skill allows read-only operations by default.

Pull Requests

View PR Details

# View PR by number
gh pr view 123

# View with web browser
gh pr view 123 --web

# View PR in JSON format
gh pr view 123 --json title,body,author,state,number,url

# View specific PR fields
gh pr view 123 --json comments,reviews,commits

List PRs

# List open PRs
gh pr list

# List PRs with filters
gh pr list --state all
gh pr list --author username
gh pr list --label bug
gh pr list --base main

# List PRs in JSON format
gh pr list --json number,title,author,state,url

PR Status and Checks

# Check PR status
gh pr status

# View PR CI checks
gh pr checks 123

# View checks for a specific PR in detail
gh pr checks 123 --watch

# View PR diff
gh pr diff 123

Get PR Comments and Reviews

# Get PR comments using GitHub API
gh api repos/OWNER/REPO/pulls/123/comments

# Get PR reviews
gh api repos/OWNER/REPO/pulls/123/reviews

# Get PR review comments
gh api repos/OWNER/REPO/pulls/123/comments

# Get issue comments (also includes PR comments)
gh api repos/OWNER/REPO/issues/123/comments

Repository Information

# View repository details
gh repo view

# View specific repo
gh repo view OWNER/REPO

# View repo in browser
gh browse

Issues

# List issues
gh issue list

# View issue details
gh issue view 123

# View issue in browser
gh issue view 123 --web

Workflows and Actions

# List workflow runs
gh run list

# View workflow run details
gh run view RUN_ID

# View run logs
gh run view RUN_ID --log

# List workflows
gh workflow list

# View workflow details
gh workflow view WORKFLOW_NAME

Common Patterns

Inspecting a PR for Review

# Get full PR context
gh pr view 123 --json title,body,author,commits,comments,reviews

# View the code changes
gh pr diff 123

# Check CI status
gh pr checks 123

Finding PRs to Review

# List open PRs
gh pr list --state open

# List PRs by author
gh pr list --author @me

# List PRs with specific label
gh pr list --label "needs-review"

Notes

This skill allows read-only gh commands by default
Mutating operations (create, merge, close, etc.) require explicit user permission
Use gh api for advanced queries not covered by gh pr commands
The GitHub CLI uses the repository context from the current directory

GitHub CLI Management

Recommended for