Connexion
sincere-arjun

github

by @sincere-arjun in DevOps & Cloud
0
0
# Install this skill:
npx skills add sincere-arjun/github-skill

Or install specific skill: npx add-skill https://github.com/sincere-arjun/github-skill

# Description

Advanced GitHub CLI wrapper for agents. Manage repos, issues, PRs, CI/CD workflows, and releases.

# SKILL.md

name: github
emoji: 🐙
description: "Advanced GitHub CLI wrapper for agents. Manage repos, issues, PRs, CI/CD workflows, and releases."
metadata:
openclaw:
requires:
bins: ["gh", "node"]
install:
- id: "gh-install"
kind: "manual"
label: "Install GitHub CLI"
url: "https://github.com/cli/cli#installation"

GitHub Enhanced Skill

Agent-friendly GitHub CLI wrapper with structured JSON output.

Prerequisites

Install GitHub CLI:

# macOS
brew install gh

# Ubuntu/Debian  
sudo apt install gh

# Or download: https://cli.github.com/

Authentication

# Login with Personal Access Token
github auth login --token <your-pat>

Create a token at: https://github.com/settings/tokens (needs repo, workflow scopes)

Repository Operations

List your repos:

github repo list
github repo list --json

View repo details:

github repo view owner/repo
github repo view --json

Issue Management

List issues:

github issue list --repo owner/repo
github issue list --state all --limit 50

Create an issue:

github issue create --repo owner/repo \
  --title "Bug: Login fails" \
  --body "Steps to reproduce..."

Close/reopen:

github issue close 42 --repo owner/repo
github issue reopen 42 --repo owner/repo

Pull Request Management

List PRs with CI status:

github pr list --repo owner/repo
github pr list --json

View PR details:

github pr view 55 --repo owner/repo

Check CI status:

github pr checks 55 --repo owner/repo

Merge a PR:

github pr merge 55 --repo owner/repo --squash --delete-branch

CI/CD Workflows

List recent runs:

github run list --repo owner/repo --limit 10

View failed logs:

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

Rerun failed jobs:

github run rerun 123456 --repo owner/repo --failed

Releases

List releases:

github release list --repo owner/repo

Create release:

github release create v1.0.0 \
  --repo owner/repo \
  --title "Version 1.0.0" \
  --notes "Release notes..."

Search repositories:

github search repos "machine learning language:python stars:>1000"

Search issues:

github search issues "bug in:label"

Search code:

github search code "function authenticate" --repo owner/repo

Global Options

  • --json — Output structured JSON for agent processing
  • --repo owner/repo — Specify target repository
  • --limit N — Limit results

Why This Skill?

The base gh CLI is powerful but verbose. This wrapper provides:
- Sensible defaults for agent workflows
- Consistent --json output option
- Colorized human-readable output
- Single binary with categorized subcommands
- Secure credential storage

# README.md

github-skill 🐙

SecureSkills Verified
Trust Score
License

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

Command Description
github auth Check authentication status
github auth login --token <token> Login with PAT
github auth logout Logout and clear credentials

Repositories

Command Description
github repo list List your repositories
github repo view [owner/repo] View repo details
github repo create --name <n> Create new repository
github repo clone <owner/repo> Clone repository

Issues

Command Description
github issue list [--repo] List open issues
github issue view <number> View issue details
github issue create --title <t> Create new issue
github issue close <number> Close issue
github issue reopen <number> Reopen issue

Pull Requests

Command Description
github pr list [--repo] List open PRs with status
github pr view <number> View PR details
github pr create --title <t> Create PR
github pr merge <number> Merge PR
github pr checks <number> View CI check status

Workflows & CI

Command Description
github run list [--repo] List recent runs
github run view <id> View run details
github run logs <id> View logs
github run logs <id> --log-failed View only failed logs
github run rerun <id> Rerun workflow

Releases

Command Description
github release list [--repo] List releases
github release view <tag> View release
github release create <tag> Create release
Command Description
github search repos <query> Search repositories
github search issues <query> Search issues
github search code <query> Search code

Global Options

Option Description
--json Output raw JSON for agent parsing
--repo <owner/repo> Specify repository
--limit <n> Limit results

🤖 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.

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.