Agent-Skills.md

Agent Skills: GitHub CLI (gh)

Use when interacting with GitHub - searching for repos/orgs/packages, exploring codebases, finding projects to use, querying branches/PRs/issues/releases/workflows, automating GitHub operations, or when users mention GitHub organizations or repositories

UncategorizedID: mathiassoeholm/dotfiles/gh-cli

Repository

mathiassoeholm/dotfiles
mathiassoeholm
21

Install this agent skill to your local

pnpm dlx add-skill https://github.com/mathiassoeholm/dotfiles/tree/HEAD/claude-code/.claude/skills/gh-cli

Skill Files

Browse the full folder contents for gh-cli.

Download Skill

Loading file tree…

claude-code/.claude/skills/gh-cli/SKILL.md

Skill Metadata

Name
gh-cli
Description
Use when interacting with GitHub - searching for repos/orgs/packages, exploring codebases, finding projects to use, querying branches/PRs/issues/releases/workflows, automating GitHub operations, or when users mention GitHub organizations or repositories

CRITICAL: You MUST use the Task tool with subagent_type: "general" to execute GitHub CLI commands. NEVER run gh commands directly in your bash session.

Example Task invocation:

Task(subagent_type="general", prompt="Use gh CLI to list branches: gh branch list --json name,updatedAt")

This preserves conversation context and isolates CLI output.

GitHub CLI (gh)

Command-line interface for GitHub. Use --json <fields> with --jq for scriptable output.

Quick Reference

| Task | Command | |------|---------| | List my PRs | gh pr list --author @me | | View PR | gh pr view <number> | | Create PR | gh pr create --fill | | Checkout PR | gh pr checkout <number> | | List issues | gh issue list | | View issue | gh issue view <number> | | Create issue | gh issue create --title "..." --body "..." | | Repo info | gh repo view | | Clone repo | gh repo clone <owner/repo> | | List releases | gh release list | | Workflow runs | gh run list | | View run | gh run view <run-id> | | Search repos | gh search repos <query> | | Search code | gh search code <query> | | API request | gh api <endpoint> | | My status | gh status | | Auth status | gh auth status |

Core Commands

| Command | Description | |---------|-------------| | gh repo | Manage repositories (create, clone, fork, view, delete, edit) | | gh pr | Manage pull requests (create, list, view, checkout, merge, close) | | gh issue | Manage issues (create, list, view, edit, close, comment) | | gh release | Manage releases (create, list, view, download, delete) | | gh gist | Manage gists (create, list, view, edit, delete) | | gh project | Work with GitHub Projects |

GitHub Actions

| Command | Description | |---------|-------------| | gh run list | List recent workflow runs | | gh run view | View a workflow run | | gh run watch | Watch a run until completion | | gh run rerun | Rerun a workflow | | gh workflow list | List workflows | | gh workflow run | Trigger a workflow | | gh cache list | List Actions caches |

Additional Commands

| Command | Description | |---------|-------------| | gh search | Search repos, issues, PRs, commits, code | | gh api | Make authenticated API requests | | gh auth | Manage authentication (login, logout, status) | | gh config | Manage configuration | | gh secret | Manage repository/org secrets | | gh variable | Manage Actions variables | | gh label | Manage issue labels | | gh ruleset | View repository rulesets |

For detailed flags and examples, see pr-commands.md, issue-commands.md, repo-commands.md, actions-commands.md, and other-commands.md in this skill directory.

Output Flags

| Flag | Description | |------|-------------| | --json <fields> | Output JSON with specified fields | | -q, --jq <expr> | Filter JSON output with jq expression | | -t, --template | Format output with Go template | | -w, --web | Open in browser |

Global Flags

| Flag | Description | |------|-------------| | -R, --repo OWNER/REPO | Select repository | | --help | Help for any command |