github

Automate GitHub workflows including PRs, issues, code reviews, and CI via the gh CLI.

Updated Dec 7, 2025
One-click install
npx skills add https://github.com/harlanljones/dotfiles --skill github-harlanljones
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github
Source: https://github.com/harlanljones/dotfiles/tree/main/dot_hermes/skills/software-development/github
Command: npx skills add https://github.com/harlanljones/dotfiles --skill github-harlanljones

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Managing GitHub work end to end—authentication, issue triage, pull request lifecycles, code review, CI monitoring, and repo administration—requires juggling many commands and API endpoints. This Skill consolidates those workflows into routed, verified procedures so nothing is done from memory or left unverified. ## Core Features & Use Cases - Full PR Lifecycle: Create branches, commit with conventional messages, open PRs, watch CI checks, auto-fix failures, and merge with squash or auto-merge. - Issue-to-PR Delivery: Carry a GitHub issue through premise validation, duplicate sweeps, regression testing, and an honest CI-verified PR. - Code Review Automation: Review local diffs or remote PRs with a structured severity checklist, then post inline comments and formal reviews (approve, request changes, comment). - Flexible Authentication: Set up auth via gh CLI, personal access tokens, SSH keys, or OAuth device flow, with curl-based REST API fallbacks when gh is unavailable. - Use Case: Ask the agent to "fix issue #42 and open a PR"—it reads the full issue thread, sweeps for duplicate PRs, implements the fix with a proven regression test, opens the PR, and shepherds CI to green. ## Quick Start Ask the agent to review PR #123 in the current repository and post a structured review with inline comments.

Frequently Asked Questions about github

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub pull request from the command line?▼

Use gh pr create with a title, body, and optional flags like --draft or --reviewer after pushing your branch. If gh is unavailable, the Skill falls back to a curl POST to the GitHub REST API pulls endpoint with your token.

How to review a GitHub PR with inline comments?▼

Fetch the PR locally with git fetch origin pull/N/head, review the diff against the base branch, then submit a formal review via gh pr review or the reviews API endpoint. Inline comments reference the head commit SHA, file path, and line number.

Does this work without the gh CLI installed?▼

Yes, every workflow includes a git plus curl fallback using a personal access token and the GitHub REST API. The gh-env.sh helper script detects which auth method is available and exports the right environment variables.

Why does gh auth login hang on a headless Linux server?▼

On keyring-less systems, gh's credential storage can block indefinitely waiting on a secret-service keyring. The documented fix is to write the token directly to ~/.config/gh/hosts.yml, which gh auth status reads without touching the keyring.

How do I diagnose and fix failing GitHub Actions CI checks?▼

Read failed logs with gh run view --log-failed or by downloading the logs zip via the API, then match the error against common patterns like test failures, lint errors, or missing dependencies. Fix the code, push, and re-check status with gh pr checks.

Can it turn a GitHub issue into a merged pull request automatically?▼

Yes, the issue-to-PR workflow reads the full issue thread, sweeps for duplicate PRs, validates the premise against current code, adds a regression test proven to fail without the fix, then opens the PR and shepherds CI honestly to completion.