3.2 KiB
title, sidebar_label, description
| title | sidebar_label | description |
|---|---|---|
| Github — GitHub via gh CLI: PRs, issues, reviews, repos, auth | Github | GitHub via gh CLI: PRs, issues, reviews, repos, auth |
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
Github
GitHub via gh CLI: PRs, issues, reviews, repos, auth.
Skill metadata
| Source | Bundled (installed by default) |
| Path | skills/software-development\github |
| Version | 2.0.0 |
| Author | Ben Barclay (benbarclay), Hermes Agent |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | github, gh, git, pull-requests, issues, code-review, repos, auth, ci |
| Related skills | codebase-inspection, requesting-code-review |
Reference: full SKILL.md
:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::
GitHub
Work GitHub end to end with the gh CLI (REST fallback where noted): auth,
issues, the PR lifecycle, issue-to-PR delivery, code review, and repo
management. This skill consolidates six former skills; each workflow lives
complete in its reference file — ALWAYS read the matching reference before
starting that workflow, the body below only routes.
Routing
| Task | Read first |
|---|---|
| Auth broken / new machine / token or SSH setup / gh login | references/auth.md |
| Create, triage, label, assign, close issues | references/issues.md |
| Branch, commit, open PR, watch CI, merge | references/pr-workflow.md |
| Carry an ISSUE to a verified PR (full delivery loop) | references/issue-to-pr.md |
| Review someone's PR: diffs, inline comments, verdict | references/code-review.md |
| Clone/create/fork repos, remotes, releases | references/repo-management.md |
Supporting assets: scripts/gh-env.sh + scripts/git-credential-token.py
(auth helpers), templates/ (PR bodies, bug report, feature request),
references/ci-troubleshooting.md, references/conventional-commits.md,
references/github-api-cheatsheet.md, references/review-output-template.md.
Core discipline (applies to every workflow)
- Preflight once per session:
gh auth status— if it fails, go toreferences/auth.mdbefore anything else. - Prefer
ghover raw REST; drop togh apionly for endpoints the porcelain lacks (the cheatsheet lists them). - Never report CI green without checking
gh pr checksyourself; never claim merged without verifyingstate,mergedAt. - Read full context before writing:
gh issue view --comments/gh pr view --comments— decisions live in threads, not titles. - Sweep for duplicates before creating anything:
gh pr list --search/gh issue list --search.
Verification
- The workflow's own reference file defines done for that task.
- Cross-cutting: every claim about remote state (CI, merge, release,
issue state) is backed by a fresh
ghread, never memory.