github-cli

What it does and when to use it

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`).

How it works

1. Common commands

---
name: github-cli
description: >
  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`).
---

# GitHub CLI

This skill owns GitHub operations. Use the local `gh` CLI for GitHub reads and
writes, including GitHub URLs and GitHub code search.

Start with `gh auth status` when the active account or authentication could
affect the result. Inspect the current repository, state, and remote data before
making a GitHub mutation; obtain any authorization that the requested mutation
requires.

## Common commands

```bash
# Search
gh search repos "query" --sort stars --limit 10
gh search code "query" --language python

# Repository
gh repo view owner/repo
gh repo clone owner/repo
gh repo create my-repo --private
gh repo fork owner/repo
gh repo sync owner/repo

# Issues and pull requests
gh issue list --repo owner/repo --state open
gh issue view 123 --repo owner/repo
gh issue create --repo owner/repo --title "Title" --body "Body"
gh pr list --repo owner/repo --state open
gh pr view 123 --repo owner/repo
gh pr create --repo owner/repo --title "Title" --body "Body"
gh pr checks 123 --repo owner/repo

# Actions and Releases
gh workflow list --repo owner/repo
gh run list --repo owner/repo --limit 10
gh run view <run-id> --repo owner/repo --log-failed
gh release list --repo owner/repo

# API and structured output
gh api repos/owner/repo
gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
```

Use `gh <command> --help` when the exact command shape is uncertain. For local
Git work, use `git`; use `gh` for the GitHub service operation around it.

Versions

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

Downloads in the last 30 days: 0 · 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-ops
  Fast GitHub operations via the gh CLI. Use when the user mentions GitHub issues, PRs, repos, actions, releases, creating or triaging issues, opening or reviewing pull requests, managing branches, inspecting repo state, or checking CI. Works on any repo the operator's gh CLI is authenticated against.
• 100github
  Drive GitHub via the official `gh` CLI — repos, issues, pull requests, releases, gists, Actions runs, and raw REST through `gh api`. Use when the user asks to inspect or manage GitHub.
• 100gh-cli
  Use for GitHub-related tasks such as managing issues, pull requests, actions runs, and repository configuration using the 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,…
• 100github
  GitHub issues, pull requests, repos, code search, releases, gists, stars, watching, forks, and Actions via the gh CLI. Use when the user mentions GitHub, an issue/PR number, a repo, a commit, a release, a gist, or code review.