Files

treatux 2a1ec15a6f docs(website): regenerate the skill docs from the shipped skill tree

website/scripts/generate-skill-docs.py is the documented source of both catalogs
and of the per-skill pages, but nothing compares its output with what is
committed, so the committed copies drifted:

- optional-skills-catalog.md was missing agent-merge-conflict-arbiter and listed
  pr-lens under blockchain (it lives in software-development);
- skills-catalog.md still listed merge-reconciler, which #98539 moved out of the
  bundled set;
- 196 pages and both catalogs carried Windows path separators — in the Path
  column and inside GitHub blob links, where a backslash is a broken URL.

This commit is the generator's output (re-running it on this branch is a no-op),
plus the orphan page #98539 left behind for merge-reconciler: no skill backs it,
its catalog row is gone, and no page links to it.

tests/skills/test_skill_docs_contract.py is the guard: the next skill that ships
without a catalog row, or a page regenerated on Windows, fails there instead of
on the published page.

2026-09-20 12:54:07 -07:00

3.2 KiB

Raw Permalink Blame History

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 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.

3.2 KiB Raw Permalink Blame History