GitHub Token

Interact with GitHub using Personal Access Tokens. Secure, user-controlled access - no OAuth, no full account access. Clone, push, branch, PR, issues. Use when user wants to work w…

Danny Shmueli

@dannyshmueli

What This Skill Does

Command-line interface for GitHub operations using Personal Access Tokens. Supports cloning, pushing, branching, pull requests, issues, and repo info retrieval via a Python script.

Replaces full OAuth flows and third-party integrations by letting users control access through scoped PATs with no account-wide permissions.

When to Use It

  • Clone a private repository using a user-provided PAT
  • Create a new branch and push changes to a GitHub repo
  • Open a pull request with a title and description
  • List all repositories the token has access to
  • Create a GitHub issue with a title and optional body
  • View repository metadata like description and visibility

Install

$ openclaw skills install @dannyshmueli/github-token

GitHub PAT

Interact with GitHub using Personal Access Tokens. User controls access via PAT scopes.

Setup

User provides their PAT:

1. Create PAT at github.com/settings/tokens
2. Select scopes (repo for full, public_repo for public only)
3. Provide token to agent

Store in TOOLS.md or pass via --token.

Commands

# List repos you have access to
python3 scripts/gh.py repos [--token TOKEN]

# Clone a repo
python3 scripts/gh.py clone owner/repo [--token TOKEN]

# Create branch
python3 scripts/gh.py branch <branch-name> [--repo owner/repo]

# Commit and push
python3 scripts/gh.py push "<message>" [--branch branch] [--repo owner/repo]

# Open a pull request
python3 scripts/gh.py pr "<title>" [--body "description"] [--base main] [--head branch]

# Create an issue
python3 scripts/gh.py issue "<title>" [--body "description"] [--repo owner/repo]

# View repo info
python3 scripts/gh.py info owner/repo

Security Model

  • User controls access via PAT scopes
  • No OAuth - no "allow full access" prompts
  • Least privilege - user creates PAT with minimal needed scopes
  • Fine-grained PATs supported for specific repo access

Token Storage

Agent stores token in TOOLS.md under ### GitHub section. Never expose in logs or messages.

Top skills in this category