gh-reference

Provides a complete command reference for the GitHub CLI covering pull requests, issues, repositories, and API operations.

1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/ETdoFresh/claude-marketplace --skill gh-reference-etdofresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-reference
Source: https://github.com/ETdoFresh/claude-marketplace/tree/main/plugins/gh/skills/gh-reference
Command: npx skills add https://github.com/ETdoFresh/claude-marketplace --skill gh-reference-etdofresh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with GitHub from the terminal requires memorizing dozens of gh CLI commands, flags, and API endpoints, and many operations like branch management, webhooks, and milestones have no dedicated command at all. This Skill gives the AI a complete reference so it can construct the correct gh command or API call for any GitHub task without guesswork. ## Core Features & Use Cases - Full Command Coverage: Documents every gh command group including pr, issue, repo, release, run, workflow, secret, variable, label, gist, auth, project, codespace, and search with all flags and JSON output fields. - API-Only Recipes: Provides ready-to-use gh api patterns for operations without dedicated commands, such as creating files via the Contents API, managing branches and tags via Git Refs, configuring webhooks, branch protection, collaborators, milestones, reactions, deployments, and organization management. - Practical Patterns: Includes HEREDOC multi-line body formatting, jq JSON filtering, GraphQL queries, pagination, and cross-repository operations with the -R flag. - Use Case: When asked to create a release with auto-generated notes, review a failing CI run, or add a webhook to a repository, the AI consults this reference to produce the exact command with correct flags on the first attempt. ## Quick Start Ask the AI to list all open pull requests assigned to you, or to create a new GitHub issue with a title and body, and it will use this reference to run the correct gh command.

Frequently Asked Questions about gh-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a pull request with the GitHub CLI?

Run gh pr create with --title and --body flags, optionally adding --base, --reviewer, --label, or --draft. Use a HEREDOC for multi-line bodies to preserve formatting, or --fill to reuse commit messages as the title and body.

How do I create or delete a branch using the gh CLI?

The gh CLI has no dedicated branch command, so use the Git Refs API via gh api. Create a branch with gh api repos/{owner}/{repo}/git/refs -f ref="refs/heads/name" -f sha="<commit-sha>", and delete one with the same endpoint using -X DELETE.

Can the GitHub CLI update files in a repo without cloning?

Yes, the Contents API via gh api can create, read, update, and delete files remotely. Content must be base64 encoded, and updates or deletes require the current file SHA, with each call producing one commit per file.

How do I filter gh CLI output with jq?

Most list and view commands support --json with field names plus -q or --jq for jq expressions. For example, gh pr list --json title -q '.[].title' prints only PR titles, and you can chain select() to filter by conditions like failed workflow runs.

What GitHub operations require the API instead of dedicated gh commands?

Operations without dedicated commands include branch and tag management, milestones, webhooks, reactions, collaborators, notifications, deployments, starring, repository dispatch events, and organization management. All of these are performed through gh api against the corresponding REST endpoints.