gh-cli

A command-line tool for working with GitHub, the code-hosting service, from a terminal. It covers pull requests, issues, releases, automated checks, and GitHub API requests.

In plain words
What is it for?
Create, inspect, review, merge, and check pull requests; manage issues and releases; run GitHub API calls; and check automated workflows.
Why use it?
It avoids switching between web pages and the terminal for routine GitHub work. It also gives the coding agent direct commands for checking changes and build results.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cdbattags/ai/gh-cli
Any agent
npx skills add cdbattags/ai --skill gh-cli
Clone the repo
git clone --depth 1 https://github.com/cdbattags/ai

Made for: Claude Code, Codex.

Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,250 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00053 $0.01250
Opus 5 $0.00026 $0.00625
Sonnet 5 $0.00011 $0.00250
Haiku 4.5 $0.00005 $0.00125

Measured 2d ago against content hash da9b6a07400d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

gh-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/skills/gh-cli/SKILL.md · 205 lines

How it starts

The opening of the file, as written. The whole thing — 205 lines — stays where its author put it; the contents beside it link to each section on GitHub.

GitHub CLI (gh)

Prerequisites

  • User is already authenticated (gh auth login completed)
  • All gh commands require required_permissions: ["full_network"] in the Shell tool

Pull Requests

# Create PR with HEREDOC body
gh pr create --title "feat: add caching layer" --body "$(cat <<'EOF'
## Summary
- Added Redis caching for API responses
- Cache TTL configurable via env var

## Test plan
- [ ] Unit tests pass
- [ ] Manual smoke test
EOF
)"

# List open PRs
gh pr list

# View PR details (accepts number, URL, or branch name)
gh pr view 42

# View in browser
gh pr view 42 --web

# Check CI status
gh pr checks 42

# View PR diff
gh pr diff 42

# Merge (auto-selects merge method)
gh pr merge 42

# Squash merge with auto-delete branch
gh pr merge 42 --squash --delete-branch

# Add review
gh pr review 42 --approve
gh pr review 42 --request-changes --body "Needs error handling"

# Checkout a PR locally
gh pr checkout 42

Issues

# Create issue
gh issue create --title "Bug: login fails on Safari" --body "Steps to reproduce..."

# Create with labels and assignee
gh issue create --title "..." --label bug --label urgent --assignee @me

# List issues (default: open)
gh issue list
gh issue list --label bug --state closed

# View issue
gh issue view 99

# Comment on issue
gh issue comment 99 --body "Fixed in PR #42"

# Close issue
gh issue close 99

# Create a branch linked to an issue
gh issue develop 99 --checkout

GitHub Actions

# List recent workflow runs
gh run list

# List runs for a specific workflow
gh run list --workflow ci.yml

# View a run's details and jobs
gh run view <run-id>

# Watch a run in real time (non-interactive: use --exit-status)
gh run watch <run-id> --exit-status

# Download artifacts
gh run download <run-id>

# Re-run failed jobs
gh run rerun <run-id> --failed

Releases

# Create release from tag
gh release create v1.2.0 --title "v1.2.0" --notes "Release notes here"

# Create release with auto-generated notes
gh release create v1.2.0 --generate-notes

# Upload assets to existing release
gh release upload v1.2.0 ./dist/*.tar.gz

# List releases
gh release list

# View a release
gh release view v1.2.0

Read the full file on GitHub · 205 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 205 lines · 53 tokens per session scan A da9b6a07400d

Subscribe to this mod's changes

gh-cli is a skill published in the GitHub repository cdbattags/ai (4 stars, last pushed 6mo ago), licensed MIT. It adds 53 tokens to every session and 1,250 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

android-feature

Workflow for implementing a new Android feature, screen, fragment, activity, dialog, adapter, or enhancement in this XML/MVVM template. Use whenever the user asks to add, build, implement, or extend functionality — before writing any code. Covers planning, the MVVM/MVI skeleton, the Android configuration checklist…

orbitalsonic/AndroidPilot · 72 tokens

android-new-project

Workflow for turning a fresh copy of this Android template into a new app — renaming the package/namespace/applicationId, branding (icons, splash, palette, fonts), Firebase setup, signing config, stripping unused sample screens, and verifying the foundation. Use when the user says they are starting a new app…

orbitalsonic/AndroidPilot · 83 tokens

template-helpers

Catalog of the reusable building blocks shipped with this Android template — BaseActivity/BaseFragment, the helpers/ extension files (navigation, lifecycle, toast, snackbar, dialogs, images, permissions, theme, locale, settings intents, date, delay), common/ (Firebase, network, observers), and…

orbitalsonic/AndroidPilot · 92 tokens

android-build-config

Gradle and build configuration rules for this template — AGP 9 / Gradle 9 DSL (built-in Kotlin, compileSdk block, optimization block instead of minify/proguard), the gradle/libs.versions.toml version catalog, R8 keep rules in keepRules/.keep, gradle.properties defaults, and manifest registration. Use when editing…

orbitalsonic/AndroidPilot · 104 tokens

android-preflight

Final verification checklist to run before declaring Android work finished — build, both themes, string resources, lifecycle and leak risks, registered permissions and components, resource parity between values and values-night, and honest reporting of what was and was not verified. Use at the end of any feature, fix…

orbitalsonic/AndroidPilot · 79 tokens

android-ui-theming

Rules for Android XML layouts, Material 3 components, semantic color tokens, light/dark theming, dimensions (sdp/ssp), string resources and localization, accessibility, and edge-to-edge insets. Use when creating or editing any layout, drawable, style, color, vector, or string resource, or when a screen must work in…

orbitalsonic/AndroidPilot · 81 tokens