github-skill 🐙

Advanced GitHub CLI wrapper for OpenClaw/Clawd agents. Manage repos, issues, PRs, CI/CD, and releases with agent-friendly JSON output. Built by SecureSkills.

🛡️ Security First

This skill has been audited with the SecureSkills 50+ Point Security Rubric:
- ✅ No filesystem access outside ~/.config/github-skill/
- ✅ Network calls only via official gh CLI to api.github.com
- ✅ Credentials stored with 600 permissions
- ✅ No arbitrary shell execution
- ✅ No data exfiltration vectors

View Full Audit Report | Trust Score: 8.5/10

📦 Installation

Prerequisites

# Install GitHub CLI first
# macOS
brew install gh

# Ubuntu/Debian
sudo apt install gh

# Or see: https://github.com/cli/cli#installation

Install Skill

# Clone and install
git clone https://github.com/sincere-arjun/github-skill.git
cd github-skill
npm link

# Or use directly
node github.js <command>

🔐 Setup

Create a GitHub Personal Access Token:
1. Go to https://github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Select scopes: repo, workflow, read:org
4. Authenticate:

github auth login --token <your-token>

🚀 Quick Start

# List your repositories
github repo list

# View repository details
github repo view owner/repo

# List open issues
github issue list --repo owner/repo

# Create a new issue
github issue create --repo owner/repo --title "Bug report" --body "Description..."

# List open PRs with check status
github pr list --repo owner/repo

# Check PR status and CI checks
github pr checks 42 --repo owner/repo

# List recent CI runs
github run list --repo owner/repo

# View failed logs
github run logs 123456 --repo owner/repo --log-failed

📚 Commands

Authentication

Repositories

Issues

Pull Requests

Workflows & CI

Releases

Search

Global Options

🤖 Agent Usage Examples

Check PR CI Status

# Get JSON for automated processing
github pr checks 42 --repo myorg/myrepo --json

# Human-readable output
github pr checks 42 --repo myorg/myrepo

Monitor CI Runs

# Check recent runs
github run list --repo myorg/myrepo --limit 5

# Rerun failed jobs
github run rerun 123456 --failed --repo myorg/myrepo

Create Release

github release create v1.2.3 \
  --title "Version 1.2.3" \
  --notes "Bug fixes and improvements" \
  --repo myorg/myrepo

🏢 About SecureSkills

github-skill is published by SecureSkills — the verified skill marketplace for OpenClaw/Clawd agents.

Why SecureSkills?

• 🔍 Every skill audited with 50+ security checkpoints
• 📊 Trust scores 0-10 with detailed breakdowns
• 🛡️ Know what you're installing — permissions, risks, mitigations
• ⚡ Curated catalog of production-ready skills

Browse More Skills

npx secureskills list
npx secureskills info github-enhanced

Visit: https://secureskills.io

🔧 Requirements

• Node.js 18+
• GitHub CLI (gh) installed
• GitHub account with API access

📄 License

MIT License — See LICENSE

Built with 🦞 for the agent internet.