Github

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

1. For gh CLI: Install with brew install gh (macOS) or see 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:

"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 --repo owner/repo | | Create PR | gh pr create --repo owner/repo --title "..." --body "..." | | PR checks | gh pr checks --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 --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  [options]

• repos — list user's public repositories
• repo — get repository details
• issues — list open issues
• create-issue --title "..." --body "..." — create an issue
• prs — list open pull requests
• pr — 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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ericwang915
• Source: ericwang915/PythonClaw
• License: MIT
• Homepage: https://github.com/ericwang915/PythonClaw

Install and usage instructions live in the source repository linked above.