---
name: github
description: "Complete GitHub operations: auth, repos, issues, PRs, code review, CI/CD, releases, trending research, and codebase metrics."
version: 1.0.0
author: Hermes Agent
license: MIT
platforms: [linux, macos, windows]
metadata:
  hermes:
    tags: [GitHub, Repositories, Pull-Requests, Issues, Code-Review, CI/CD, Git, Authentication, Releases, Trending, Metrics]
    related_skills: [git, huggingface-hub, codebase-inspection]
---

# GitHub — Complete Operations Library

This umbrella skill covers all GitHub workflows. Each subsection corresponds to a focused area; load the relevant `references/` and `templates/` for detailed scripts and starter files.

## 1. Authentication

`gh` CLI path and helper script. See `references/github-auth.md` and `scripts/gh-env.sh`.

## 2. Repository Management

Create, clone, fork, configure, manage releases and secrets. See `references/github-api-cheatsheet.md`.

## 3. Issues

Create, search, triage, label, assign. Templates at `templates/bug-report.md` and `templates/feature-request.md`.

## 4. Pull Request Lifecycle

Push, create PR, monitor CI, auto-fix failures, squash-merge. See `references/ci-troubleshooting.md`, `references/conventional-commits.md`, `templates/pr-body-bugfix.md`, `templates/pr-body-feature.md`.

## 5. Code Review

Review local changes or open PRs; correctness, security, tests. See `references/review-output-template.md`.

## 6. Trending Research

Scrape `github.com/trending`, validate integrity, fetch READMEs, produce structured reports. See `references/known-sources.md`, `references/pitfalls.md`, `references/cron-headless-runtime.md`, `references/cron-html-rendering.md`, `references/cron-script-templates.md`, `references/email-html-template.md`, `references/email-html-template.html`, and `scripts/validate_trending_source.py`.

## 7. Codebase Metrics

LOC, language breakdown, file counts, and code-vs-comment ratios via `pygount`.

## Prerequisites (shared)

Authenticated GitHub access (Section 1). For API-heavy scripts, ensure `GITHUB_TOKEN` is set or `gh` is installed.