gh-cli

What it does and when to use it

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

How it works

1. Common workflows
2. Best practices

---
name: gh-cli
description: Use for GitHub-related tasks such as managing issues, pull requests, actions runs, and repository configuration using the GitHub CLI (gh).
metadata:
  internal: true
---

# 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](references/commands.md) for a comprehensive list of commands and examples.

Versions

Database snapshot: 13.11.2026 · package version bba7135d1801 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

• 95github
  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",…
• 100github
  Create and manage GitHub issues, pull requests, workflows, and repositories using the gh CLI. Use when asked to open a PR, merge a pull request, check repo actions, list issues, create a branch, or manage GitHub projects.
• 95github-cli
  MUST USE for GitHub-related operations, including a GitHub URL, repository or code search, Issues, pull requests, Actions, Releases, permissions, and API requests. Use the local GitHub CLI (`gh`).
• 100github
  Interact with GitHub using the `gh` CLI. Use when users ask about pull requests, issues, CI/CD status, workflow runs, repository information, or want to create, review, or merge PRs. Covers `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, pull requests, actions, checks,…
• 92github
  Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUB_TOKEN environment variable and GitHub CLI. Use when working with code hosted on GitHub or managing GitHub resources.
• 100github
  Use when automating GitHub issues, pull requests, reviews, CI checks, labels, releases, or engineering collaboration loops through the GitHub CLI.