name: github
description: Work with GitHub using the gh CLI. Use when creating/managing pull requests, reviewing code, managing issues, viewing GitHub Actions runs, creating releases, or making API requests. Triggers on GitHub-related tasks like "create a PR", "list open issues", "check CI status", "merge this PR", or "create a release".
allowed-tools: Bash, Read, Task

GitHub CLI Skill

Use gh for all GitHub operations from the command line.

Prerequisites

Check authentication status:

gh auth status

If not authenticated:

gh auth login

Quick Reference

Core Workflows

Pull Requests

Create a PR from current branch:

gh pr create --fill                    # Auto-fill title/body from commits
gh pr create --title "Title" --body "Description"
gh pr create --draft                   # Create as draft
gh pr create --base main               # Target specific branch

List and filter PRs:

gh pr list                             # Open PRs
gh pr list --state all                 # All PRs
gh pr list --author @me                # Your PRs
gh pr list --search "review:required"  # Needs review

For complete PR operations: See references/pr.md

Code Review

Review a PR:

gh pr review 123 --approve
gh pr review 123 --request-changes --body "Please fix X"
gh pr review 123 --comment --body "Looks good overall"

View changes:

gh pr diff 123                         # View diff
gh pr checks 123                       # View CI status

For complete review workflows: See references/review.md

Issues

Create and manage issues:

gh issue create --title "Bug" --body "Description"
gh issue list --label bug
gh issue view 123
gh issue close 123

For complete issue operations: See references/issues.md

GitHub Actions

View workflow runs:

gh run list                            # Recent runs
gh run view                            # Latest run details
gh run view 123456                     # Specific run
gh run watch                           # Watch current run

For complete Actions workflows: See references/actions.md

Releases

Create releases:

gh release create v1.0.0               # Create from tag
gh release create v1.0.0 --generate-notes
gh release list

For complete release operations: See references/releases.md

API Requests

Make authenticated API calls:

gh api repos/{owner}/{repo}
gh api repos/{owner}/{repo}/pulls --jq '.[].title'

For complete API usage: See references/api.md

Common Flags

Repository Context

gh auto-detects the current repository. Override with:

gh pr list -R owner/repo

Or set default:

gh repo set-default owner/repo