Teknium
c49fa88b80
* refactor(skills): shipped-set slim — 15 skills to optional, github six-way merge, pdf absorbs OCR+nano-pdf, channel-gated teams pipeline
Maintainer-directed shipped-skills curation (skills index 1,900 -> ~1,400
tok/call on desktop; every session pays the index, so this is a per-call
diet on all installs):
- optional-skills moves (installable via skills hub, history preserved):
creative comfyui/ascii-art/excalidraw/pretext/sketch/touchdesigner-mcp;
ALL of mlops (huggingface-hub, llama-cpp, serving-llms-vllm,
weights-and-biases, evaluating-llms-harness — subcategory structure
kept); research-paper-writing (55 supporting files, 17.3K-tok load);
openhue; blogwatcher (first taught the cronjob monitor-field watch
pattern + web_extract instead of pre-cron manual workflows)
- DELETED session-librarian (Aug-12 'inspired by Perplexity Computer'
port, never maintainer-intended; session_search covers discovery)
- github: six skills (auth, issues, pr-workflow, issue-to-pr,
code-review, repo-management) merged into ONE software-development/
github skill — routing body + complete per-workflow references;
benbarclay authorship credited; codebase-inspection rides along;
discipline pins from test_github_issue_to_pr_skill.py preserved
against the reference body in the new test_github_skill.py
- pdf absorbs ocr-and-documents + nano-pdf as references/ + scripts
(extract_pymupdf, extract_marker converted to the argparse house
standard its contract test enforces)
- NEW session_platforms frontmatter gate (metadata.hermes): hides a
skill from the index on gateway channels it is not for; fail-open on
unknown platform; teams-meeting-pipeline gated to [teams, cron]
- blocked-page-recovery: research -> new web category; trigger-first
description ('Use when a fetch fails: 403/429, paywall, WAF, bot
wall.') so the model actually reaches for it on blocked fetches
- docs regenerated via generate-skill-docs.py (195 pages); related_skills
swept repo-wide; tests: 1672 passed (2 openclaw failures pre-existing
on clean main, Windows-local)
* chore: ignore .skills_prompt_snapshot.json (local index cache, accidentally committed)
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
---
|
|
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.
|