github

1---2name: github3description: "GitHub via gh CLI: PRs, issues, reviews, repos, auth."4version: 2.0.05author: Ben Barclay (benbarclay), Hermes Agent6license: MIT7platforms: [linux, macos, windows]8metadata:9  hermes:10    tags: [github, gh, git, pull-requests, issues, code-review, repos, auth, ci]11    category: software-development12    related_skills: [codebase-inspection, requesting-code-review]13---14 15# GitHub16 17Work GitHub end to end with the `gh` CLI (REST fallback where noted): auth,18issues, the PR lifecycle, issue-to-PR delivery, code review, and repo19management. This skill consolidates six former skills; each workflow lives20complete in its reference file — ALWAYS read the matching reference before21starting that workflow, the body below only routes.22 23## Routing24 25| Task | Read first |26|---|---|27| Auth broken / new machine / token or SSH setup / gh login | `references/auth.md` |28| Create, triage, label, assign, close issues | `references/issues.md` |29| Branch, commit, open PR, watch CI, merge | `references/pr-workflow.md` |30| Carry an ISSUE to a verified PR (full delivery loop) | `references/issue-to-pr.md` |31| Review someone's PR: diffs, inline comments, verdict | `references/code-review.md` |32| Clone/create/fork repos, remotes, releases | `references/repo-management.md` |33 34Supporting assets: `scripts/gh-env.sh` + `scripts/git-credential-token.py`35(auth helpers), `templates/` (PR bodies, bug report, feature request),36`references/ci-troubleshooting.md`, `references/conventional-commits.md`,37`references/github-api-cheatsheet.md`, `references/review-output-template.md`.38 39## Core discipline (applies to every workflow)40 41- Preflight once per session: `gh auth status` — if it fails, go to42  `references/auth.md` before anything else.43- Prefer `gh` over raw REST; drop to `gh api` only for endpoints the44  porcelain lacks (the cheatsheet lists them).45- Never report CI green without checking `gh pr checks` yourself; never46  claim merged without verifying `state,mergedAt`.47- Read full context before writing: `gh issue view --comments` /48  `gh pr view --comments` — decisions live in threads, not titles.49- Sweep for duplicates before creating anything:50  `gh pr list --search` / `gh issue list --search`.51 52## Verification53 54- The workflow's own reference file defines done for that task.55- Cross-cutting: every claim about remote state (CI, merge, release,56  issue state) is backed by a fresh `gh` read, never memory.57