How do I install the Github skill?

Run npx skillmds@latest add ericwang915/github in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github?

ericwang915 (@ericwang915) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github by ericwang915 — Agent Skill

Name: Github
Author: ericwang915

Github

GitHub operations via gh CLI or Python API. Use when: listing repos, creating/viewing issues and PRs, checking CI runs, managing releases, or querying the GitHub API. NOT for: general git commands (use git directly), cloning private repos without auth.

ericwang915 cfbcaa7 2 files · 7.4 KB Updated Sep 17, 2026

File contents

GitHub

When to Use

List repositories, issues, or pull requests
Create or view issues and PRs
Check CI/workflow run status
Create or manage releases
Query GitHub REST or GraphQL API
Review PR checks, comments, or status

When NOT to Use

General git commands (commit, push, branch) — use git directly
Cloning public repos — use git clone without this skill
Tasks that don't involve GitHub (e.g., local file operations)

Setup

For gh CLI: Install with brew install gh (macOS) or see cli.github.com
Auth: Run gh auth login or set GH_TOKEN / GITHUB_TOKEN
For Python fallback: Create a PAT at https://github.com/settings/tokens and add to pythonclaw.json:

"skills": {
  "github": {
    "token": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Usage/Commands

gh CLI (Preferred)

Action	Command
List PRs	`gh pr list --repo owner/repo`
View PR	`gh pr view <number> --repo owner/repo`
Create PR	`gh pr create --repo owner/repo --title "..." --body "..."`
PR checks	`gh pr checks <number> --repo owner/repo`
List issues	`gh issue list --repo owner/repo`
Create issue	`gh issue create --repo owner/repo --title "..." --body "..."`
Workflow runs	`gh run list --repo owner/repo`
View run	`gh run view <run_id> --repo owner/repo`
REST API	`gh api /repos/owner/repo`
GraphQL	`gh api graphql -f query='{ viewer { login } }'`

Python Fallback

When gh is not installed or for custom logic:

python {skill_path}/gh.py <command> [options]

repos <user> — list user's public repositories
repo <owner/repo> — get repository details
issues <owner/repo> — list open issues
create-issue <owner/repo> --title "..." --body "..." — create an issue
prs <owner/repo> — list open pull requests
pr <owner/repo> <number> — get PR details

Notes

Prefer gh CLI for standard operations; it handles auth, pagination, and output formatting
Use {skill_path}/gh.py when you need Python-specific behavior or gh is unavailable
For CI runs, gh run list and gh run view show Actions workflow status

---name: githubdescription: GitHub operations via gh CLI or Python API. Use when: listing repos, creating/viewing issues and PRs, checking CI runs, managing releases, or querying the GitHub API. NOT for: general git commands (use git directly), cloning private repos without auth.---# GitHub## When to Use- [ ] List repositories, issues, or pull requests- [ ] Create or view issues and PRs- [ ] Check CI/workflow run status- [ ] Create or manage releases- [ ] Query GitHub REST or GraphQL API- [ ] Review PR checks, comments, or status## When NOT to Use- [ ] General git commands (commit, push, branch) — use `git` directly- [ ] Cloning public repos — use `git clone` without this skill- [ ] Tasks that don't involve GitHub (e.g., local file operations)## Setup1. **For gh CLI**: Install with `brew install gh` (macOS) or see [cli.github.com](https://cli.github.com/)2. **Auth**: Run `gh auth login` or set `GH_TOKEN` / `GITHUB_TOKEN`3. **For Python fallback**: Create a PAT at https://github.com/settings/tokens and add to `pythonclaw.json`:```json"skills": { "github": { "token": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }}```## Usage/Commands### gh CLI (Preferred)| Action | Command ||--------|---------|| List PRs | `gh pr list --repo owner/repo` || View PR | `gh pr view <number> --repo owner/repo` || Create PR | `gh pr create --repo owner/repo --title "..." --body "..."` || PR checks | `gh pr checks <number> --repo owner/repo` || List issues | `gh issue list --repo owner/repo` || Create issue | `gh issue create --repo owner/repo --title "..." --body "..."` || Workflow runs | `gh run list --repo owner/repo` || View run | `gh run view <run_id> --repo owner/repo` || REST API | `gh api /repos/owner/repo` || GraphQL | `gh api graphql -f query='{ viewer { login } }'` |### Python FallbackWhen `gh` is not installed or for custom logic:```bashpython {skill_path}/gh.py <command> [options]```- `repos <user>` — list user's public repositories- `repo <owner/repo>` — get repository details- `issues <owner/repo>` — list open issues- `create-issue <owner/repo> --title "..." --body "..."` — create an issue- `prs <owner/repo>` — list open pull requests- `pr <owner/repo> <number>` — get PR details## Notes- Prefer `gh` CLI for standard operations; it handles auth, pagination, and output formatting- Use `{skill_path}/gh.py` when you need Python-specific behavior or gh is unavailable- For CI runs, `gh run list` and `gh run view` show Actions workflow status

Frequently asked questions