GitHub CLI

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.

Security Scan

The skill is an instruction-only wrapper for the official GitHub CLI and its requirements and install steps match that purpose.

Purpose & Capability

Name and description match the declared requirements (the gh binary). The brew/apt install entries are appropriate for installing GitHub CLI.

Instruction Scope

SKILL.md only instructs running gh commands (pr, run, api, issue) and explains flags; it does not request unrelated files, environment variables, or external endpoints.

Install Mechanism

Installers are standard package managers (brew, apt) for the gh formula/package — low-risk and proportionate to the skill's purpose.

Credentials

The skill requests no env vars, which is appropriate. Note: gh uses whatever local GitHub authentication is configured (gh auth, GITHUB_TOKEN, or credential helpers), so the skill will operate with your existing GitHub credentials if present.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes or modify other skills' configs; autonomous invocation is allowed but is the platform default.

Assessment

This skill simply gives the agent recipes for using the official gh CLI. Before installing: ensure you trust the agent to run gh commands under your account (those commands will use whichever GitHub credentials are already configured on the machine), prefer installing gh from your OS package manager (brew/apt) or GitHub's official releases, and be cautious about granting autonomous action if you want to prevent the agent from performing write operations (merges, issue edits, workflow reruns) — consider limiting the token or testing with read-only commands first.

GitHub Skill

Use the gh CLI to interact with GitHub. Always specify --repo owner/repo when not in a git directory, or use URLs directly.

Pull Requests

Check CI status on a PR:

gh pr checks 55 --repo owner/repo

List recent workflow runs:

gh run list --repo owner/repo --limit 10

View a run and see which steps failed:

gh run view <run-id> --repo owner/repo

View logs for failed steps only:

gh run view <run-id> --repo owner/repo --log-failed

API for Advanced Queries

The gh api command is useful for accessing data not available through other subcommands.

Get PR with specific fields:

gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

JSON Output

Most commands support --json for structured output. You can use --jq to filter:

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'