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.

⭐28stars🔀4forks📁View on GitHub🕐Updated Jan 9, 2026⬇️1downloads

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.
namegithub-cli
descriptionGitHub 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 mode
  • scripts/view-failed-logs.sh - View failed logs for a run or job