gh

GitHub CLI usage and workflow patterns. Use when working with GitHub repositories, pull requests, issues, or API interactions.

SKILL.md

GitHub

gh CLI

Use gh for all GitHub interactions. It handles authentication automatically and works with private repositories.

Common Commands

  • gh repo view — view repository README and metadata
  • gh issue view <number> — view issue details
  • gh pr view <number> — view pull request details
  • gh run view <run_id> — view workflow run status
  • gh run view --job <job_id> --log — view job logs

API Access

Use gh api for operations not covered by built-in commands:

gh api repos/{owner}/{repo}/contents/{path}  # fetch file contents
gh api repos/{owner}/{repo}/pulls/{number}/comments  # PR review comments

Reference Files

  • reviews.md: Pull request review patterns

Workflows

Pull Request

  • You must git push a branch before creating a pull request with gh pr create.