Gh CLI

Use for GitHub-related tasks such as managing issues, pull requests, actions runs, and repository configuration using the GitHub CLI (gh).

yamcodes Updated 151 repo stars

File contents

Gh CLI

This skill provides guidance for using the GitHub CLI (gh) to automate and streamline GitHub workflows.

Common workflows

Actions & runs

  • List recent runs: gh run list
  • View a specific run: gh run view <run-id>
  • View job logs: gh run view <run-id> --job <job-id> --log
  • Rerun failed jobs: gh run rerun <run-id> --failed

Pull requests

  • List PRs: gh pr list
  • View PR details: gh pr view <pr-number>
  • Check PR status: gh pr status
  • Create a PR: gh pr create --title "..." --body "..."
  • Merge a PR: gh pr merge <pr-number> --merge (or --squash, --rebase)

Issues

  • List issues: gh issue list
  • View issue: gh issue view <issue-number>
  • Create issue: gh issue create --title "..." --body "..."

Best practices

  • Use --repo: When working in a multi-repo context or if not in a git repo, always specify --repo <owner>/<repo>.
  • JSON Output: Use --json with -q (jq filter) for scriptable output.
  • Help: Use gh <command> --help to discover more flags.

See references/commands.md for a comprehensive list of commands and examples.

yamcodes/arkenv commit eaf762a49e

Frequently asked questions

npx get-skill add yamcodes/gh-cli