github · nousresearch — Claude Code skill: what it does, how to install
Routes GitHub workflows through the gh CLI, covering issues, PR lifecycles, code reviews, and repo tasks. Designed for tracking delivery straight from the terminal.
MIT 245 installs ★ 265,216 updated 2026-10-25
npx skills add NousResearch/hermes-agent --skill github -a claude-codeWhat github does
This skill consolidates GitHub operations into reference playbooks across six distinct areas: authentication, issue tracking, the PR lifecycle, issue-to-PR delivery, code reviews, and repository management. Actions rely on the gh CLI, falling back to gh api only when native commands are missing.
The package includes helper scripts scripts/gh-env.sh and scripts/git-credential-token.py, along with PR templates and guides for CI troubleshooting. Built-in rules demand fresh remote verification: checking gh pr checks before reporting successful builds, confirming state and mergedAt attributes before declaring a merge, and inspecting comment threads prior to making edits.
Without an active gh login, operations halt immediately during the mandatory gh auth status preflight check.
What it helps with
- deliver verified pull requests directly from repository issues
- review pull requests with diff inspection and inline comments
- verify CI check results before merging pull requests
- triage, label, and assign project issues
- configure authentication tokens or SSH keys for git workflows
Example prompts for the agent
- Check the CI status for PR #12 and merge it if all checks pass.
- Review PR #45 with inline comments on the diff and provide a verdict.
- Pick up issue #88, create a branch, and open a verified pull request.
How to install github
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill github -a claude-code2Manually: put the files in place
~/.claude/skills/github/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/github/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill github -a codex2Manually: put the files in place
.agents/skills/github/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill github -a cursor2Manually: put the files in place
.cursor/skills/github/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NousResearch/hermes-agent skills/software-development/github2Manually: put the files in place
.github/skills/github/SKILL.md1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill github -a gemini-cli2Platform CLI
gemini skills install https://github.com/NousResearch/hermes-agent --path skills/software-development/githubManually: put the files in place
.devin/skills/github/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill github -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about github
How to install github in Claude Code?
Run npx skills add NousResearch/hermes-agent --skill github -a claude-code in your terminal.
What does the github skill do?
It handles end-to-end GitHub tasks through the gh CLI, managing issues, pull requests, CI status checks, and code reviews.
What dependencies are required for this skill?
You need the gh CLI installed and authenticated. The skill runs gh auth status at the start of each session and stops if credentials are missing.
Source text
SKILL.md · MIT
---
name: github
description: "GitHub via gh CLI: PRs, issues, reviews, repos, auth."
version: 2.0.0
author: Ben Barclay (benbarclay), Hermes Agent
license: MIT
platforms: [linux, macos, windows]
metadata:
hermes:
tags: [github, gh, git, pull-requests, issues, code-review, repos, auth, ci]
category: software-development
related_skills: [codebase-inspection, requesting-code-review]
---
# 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 to
`references/auth.md` before anything else.
- Prefer `gh` over raw REST; drop to `gh api` only for endpoints the
porcelain lacks (the cheatsheet lists them).
- Never report CI green without checking `gh pr checks` yourself; never
claim merged without verifying `state,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 `gh` read, never memory.
© Ben Barclay (benbarclay), Hermes Agent · MIT · NousResearch/hermes-agent
Similar skills
All skills for Git and GitHub →github by other authors comes first.