EmanuProds/dotfiles / skills/cli-gh
cli-gh
UnverifiedUse 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.
GitHub CLI
This skill is coordination-exempt: skip the ai-coord gate for its declared work.
Routing
Use yeet to author or update a pull request, issue, issue comment, or discussion. yeet owns semantic analysis,
repository templates, Paul's writing voice, idempotency, and direct posting. Route repository renames through
repo-rename so GitHub and local continuity change together.
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.
Workflow
-
Resolve the repository explicitly when cwd is ambiguous. Let the first required read-only command validate authentication. Run
gh auth statusonly for auth diagnosis. -
Use installed
gh <command> <subcommand> --helpto resolve flags, JSON fields, and command behavior. CLI JSON field names can differ from API fields. Prefer--jsonwith--jqfor structured output. -
Preview broad writes with the repository, exact targets, commands, and issue/PR impact. An already requested ordinary write does not require a second approval.
CI Failure Triage
Use this workflow when the user asks why CI fails or asks to fix a failing run. Keep each command output bounded.
-
Find the failing runs for the branch or the commit:
gh run list --branch <branch> --status failure --limit 5 gh run list --commit <sha> --status failure --limit 5 -
Extract only the failed-step lines. Never print the raw log.
gh run view <run-id> --log-failed | rg --no-config -n 'error|FAIL|panic|✗' | head -80 -
Check toolchain drift before you change code. Compare the versions pinned in
.github/workflows/*.ymlwith the local--versionoutput. Common cases are Foundry (forge), Bun (bun), Node.js (node), and Rust (rustc). -
If the user requested a fix, fix the cause and push the commit.
-
Get the new run ID with
gh run list --commit <new-sha> --limit 5. Then watch that run:gh run watch <run-id> --exit-status --compact -
Report the run URL from
gh run view <run-id> --json url --jq .urland the final run status.
Notable Flags (gh 2.98+)
gh pr checkout --worktree <path>andgh issue develop --checkout --worktree <path>check out into a linked git worktree instead of switching the current branch.gh search issues --search-type semantic|hybridranks by relevance: issues only, one page, no--sort/--order, not on GitHub Enterprise Server.gh config set api_host <gateway> --host <host>routes that host's API traffic through a gateway. The feature is experimental and is not a security boundary.gh auth loginandgh auth refreshcopy OAuth device codes to the clipboard by default (2.101+). To opt out, rungh config set clipboard disabled.--attach '<file>#<alt>'on issue/PR create, edit, and comment uploads images or videos. Route those writes throughyeet.
Completion
Complete when command output verifies the requested GitHub data or state. After a write, fetch the resulting resource. On a partial or ambiguous failure, check whether it changed before retrying. Report the verified state and URL or stable identifier. Include the concrete error and next action when incomplete, and distinguish an unknown result from a confirmed failure.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 117k | Updated | Claude CodeCodex | Unverified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 107k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 107k | Updated | Claude CodeCodex | Verified | Install |