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.
1---2name: cli-gh3description: Use for GitHub CLI automation: repository reads, workflow runs, search, codespaces, releases, configuration, or gh command syntax. Use yeet for contribution writes to PRs, issues, comments, or discussions.4---5
6# GitHub CLI
7
8Route GitHub CLI work through current `gh` help and load only the reference for the active task.
9
10## Boundary with `yeet`
11
12Use `yeet` when the requested outcome is to create or update a pull request, issue, issue comment, or discussion. `yeet`
13owns semantic analysis, repository templates, Paul's writing voice, idempotency, and direct posting. Use this skill for
14read-only GitHub inspection, command syntax, searches, workflow operations, codespaces, releases, configuration, and
15other GitHub automation.
16
17## Authority
18
19- Read and inspect without confirmation.
20- Execute reversible or ordinary GitHub writes only when the user explicitly requested that outcome.
21- Never delete repositories, releases/assets, workflow runs/caches, secrets/variables, keys, codespaces, extensions, or
22 gists.
23- Label deletion is the sole destructive exception: show the target repo, exact labels, commands, and issue/PR impact,
24 then require approval in a subsequent message before `gh label delete ... --yes`.
25- Route repository renames through `repo-rename` so GitHub and local continuity change together.
26
27## Workflow
28
291. Resolve the repository explicitly when cwd is ambiguous. Let the first required read-only command validate
30 authentication; run `gh auth status` only for auth diagnosis.
31
322. Inspect `gh <command> <subcommand> --help` for the installed version before relying on flags or JSON fields. Prefer
33 `--json` plus `--jq` for machine-readable results.
34
353. Load only the relevant reference:
36
37 | Task | Reference |
38 | --------------------------------------------------------- | ------------------------------------ |
39 | Workflow runs, checks, logs | `references/workflows-actions.md` |
40 | Releases | `references/releases.md` |
41 | Search | `references/search.md` |
42 | JSON fields and jq | `references/json-output.md` |
43 | Labels | `references/labels.md` |
44 | Codespaces | `references/codespaces.md` |
45 | Discussions syntax (not authored contribution workflow) | `references/discussions.md` |
46 | Gists | `references/gists.md` |
47 | Aliases, API, extensions, org/projects, secrets, rulesets | `references/advanced-features.md` |
48 | Reusable automation patterns | `references/automation-workflows.md` |
49 | Failures and auth/rate limits | `references/troubleshooting.md` |
50
514. Preview commands that have broad write scope. After a requested write, fetch the resulting resource and report its
52 URL or stable identifier.
53
54Completion requires the requested GitHub state or data plus command/output evidence. On a partial or ambiguous write
55failure, check whether the resource changed before retrying.