github-cli
GitHub CLI (gh) commands for PR workflows - checking CI status, viewing failed test logs, creating and updating pull requests. Use when working with GitHub PRs, checking why CI failed, or managing PR metadata.
When & Why to Use This Skill
This Claude skill provides a comprehensive suite of GitHub CLI (gh) commands specifically tailored for optimizing Pull Request (PR) workflows. It enables developers to seamlessly monitor CI/CD status, retrieve detailed logs from failed test runs, and manage the entire PR lifecycle—from creation and metadata updates to local checkouts. By integrating these essential GitHub actions into the AI workspace, it significantly reduces context switching and accelerates the software development life cycle (SDLC).
Use Cases
- CI/CD Pipeline Monitoring: Quickly check the status of automated checks and watch for completion to ensure code quality before merging.
- Rapid Debugging: Access and analyze logs for failed GitHub Actions jobs directly to identify and resolve build errors without navigating the web UI.
- Automated PR Management: Create new pull requests with auto-filled details, assign reviewers, and manage labels or milestones programmatically.
- Workflow Integration: Use provided scripts to automate repetitive tasks like checking PR health or viewing failed logs across multiple branches.
| name | github-cli |
|---|---|
| description | GitHub CLI (gh) commands for PR workflows - checking CI status, viewing failed test logs, creating and updating pull requests. Use when working with GitHub PRs, checking why CI failed, or managing PR metadata. |
GitHub CLI for PR Workflows
Quick reference for gh commands focused on pull request workflows.
Checking PR Status
# Check CI status for current branch's PR
gh pr checks
# Check specific PR
gh pr checks 123
# Watch until checks finish
gh pr checks --watch
# Only show required checks
gh pr checks --required
# JSON output for scripting
gh pr checks --json name,state,conclusion
Exit codes: 0 = passed, 1 = failed, 8 = pending
Viewing Failed Test Logs
# View run summary (interactive picker if no ID)
gh run view
# View specific run with job details
gh run view <run-id> -v
# View logs for failed steps only (most useful)
gh run view <run-id> --log-failed
# View full log for a specific job
gh run view --job <job-id> --log
# Open in browser
gh run view <run-id> --web
To get job ID from a URL like .../runs/123/job/456, job ID is 456.
Creating PRs
# Interactive (prompts for title/body)
gh pr create
# With title and body
gh pr create --title "Fix bug" --body "Details here"
# Auto-fill from commit messages
gh pr create --fill
# Draft PR
gh pr create --draft
# With reviewers and labels
gh pr create -r reviewer1,reviewer2 -l bug,urgent
# Specify base branch
gh pr create --base develop
Updating PRs
# Edit title/body
gh pr edit 123 --title "New title" --body "New body"
# Add/remove labels
gh pr edit 123 --add-label "bug" --remove-label "wip"
# Add/remove reviewers
gh pr edit 123 --add-reviewer alice --remove-reviewer bob
# Self-assign
gh pr edit 123 --add-assignee "@me"
# Change base branch
gh pr edit 123 --base main
Other Useful Commands
# View PR details
gh pr view 123
# View PR in browser
gh pr view 123 --web
# List open PRs
gh pr list
# Checkout PR locally
gh pr checkout 123
# View PR comments
gh api repos/{owner}/{repo}/issues/123/comments
# Re-run failed jobs
gh run rerun <run-id> --failed
Scripts
scripts/check-pr.sh- Check PR status with optional watch modescripts/view-failed-logs.sh- View failed logs for a run or job