cli-gh

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.

By paulrberg · 2,757 installs

npx skills add paulrberg/agent-skills --skill cli-gh

Source repository · Upstream listing

GitHub CLI This skill is coordination exempt: skip the ai coord gate for its declared work. Route GitHub CLI work through current gh help and load only the reference for the active task. Boundary with yeet 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. Use this skill for read only GitHub inspection, command syntax, searches, workflow operations, codespaces, releases, configuration, and automation that does not author contribution content. 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 1. 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. 2. Inspect gh <command <subcommand help for the installed version before relying on flags or JSON fields. Prefer json plus jq for machine readable results. 3. 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 4. 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. User Facing Output Use ⚠️ GitHub write preview for broad writes, showing the repository, exact targets, and issue/PR impact in a compact table, with each exact command in its own fenced block; an already requested ordinary write does not require a second approval. For label deletion, use ⛔ Destructive approval required and ask for approval in a later message. After a verified write, use ✅ GitHub operation complete with the action, repository, resource, and URL or stable ID. On failure, state the attempted operation, verified resulting state, concrete error, and next action without implying a write succeeded. Keep commands, JSON, identifiers, diagnostics, and output intended for piping undecorated.