About github
A GitHub workflow skill for developers using the `gh` CLI. It covers authentication, issues, pull requests, reviews, and repository management, with task-specific references and checks for remote state.
Key features
- 01Authentication setup and troubleshooting
- 02Issue creation and triage
- 03Pull request and CI workflows
- 04Issue-to-PR delivery
- 05Code review
- 06Repository and release management
Use cases
- 01Setting up GitHub access on a new machine
- 02Taking an issue through a verified pull request
- 03Reviewing a pull request and its discussion
- 04Managing repositories, remotes, and releases
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nousresearch/ hermes-agent --skill githubAfter installing, type/githubin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/auth.mdci-troubleshooting.mdcode-review.mdconventional-commits.mdgithub-api-cheatsheet.mdissue-to-pr.mdissues.mdpr-workflow.mdrepo-management.mdreview-output-template.mdscripts/gh-env.shgit-credential-token.pytemplates/bug-report.mdfeature-request.mdpr-body-bugfix.mdpr-body-feature.mdDetails
From the project READMEGitHub
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.