cli-gh

SKILL.md

GitHub CLI

Route GitHub CLI work through current gh help and load only the reference for the active task.

Boundary with yeet

Use yeet when the requested outcome is to create or update a pull request, issue, issue comment, or discussion. yeet
owns semantic analysis, repository templates, Paul's writing voice, idempotency, and direct posting. Use this skill for
read-only GitHub inspection, command syntax, searches, workflow operations, codespaces, releases, configuration, and
other GitHub automation.

Authority

Read and inspect without confirmation.

Execute reversible or ordinary GitHub writes only when the user explicitly requested that outcome.

Never delete repositories, releases/assets, workflow runs/caches, secrets/variables, keys, codespaces, extensions, or
gists.

Label deletion is the sole destructive exception: show the target repo, exact labels, commands, and issue/PR impact,
then require approval in a subsequent message before gh label delete ... --yes.

Route repository renames through repo-rename so GitHub and local continuity change together.

Workflow

Resolve the repository explicitly when cwd is ambiguous. Let the first required read-only command validate
authentication; run gh auth status only for auth diagnosis.

Inspect gh <command> <subcommand> --help for the installed version before relying on flags or JSON fields. Prefer
--json plus --jq for machine-readable results.

Load only the relevant reference:

Task
Reference

Workflow runs, checks, logs
references/workflows-actions.md

Releases
references/releases.md

Search
references/search.md

JSON fields and jq
references/json-output.md

Labels
references/labels.md

Codespaces
references/codespaces.md

Discussions syntax (not authored contribution workflow)
references/discussions.md

Gists
references/gists.md

Aliases, API, extensions, org/projects, secrets, rulesets
references/advanced-features.md

Reusable automation patterns
references/automation-workflows.md

Failures and auth/rate limits
references/troubleshooting.md

Preview commands that have broad write scope. After a requested write, fetch the resulting resource and report its
URL or stable identifier.

Completion requires the requested GitHub state or data plus command/output evidence. On a partial or ambiguous write
failure, check whether the resource changed before retrying.