Agent Skills › swarmclawai/swarmclaw › github

github

GitHub

基于 gh CLI 的 GitHub 操作技能，支持 PR 管理、Issue 处理、CI/CD 运行查看及 API 查询。用于自动化代码审查、状态检查和流程编排。

skills/github/SKILL.md swarmclawai/swarmclaw

Trigger Scenarios

检查 PR 状态或 CI 结果创建或评论 Issue 列出或筛选 PR/Issue 查看 CI 运行日志

Install

npx skills add swarmclawai/swarmclaw --skill github -g -y

More Options

Use without installing

npx skills use swarmclawai/swarmclaw@github

指定 Agent (Claude Code)

npx skills add swarmclawai/swarmclaw --skill github -a claude-code -g -y

安装 repo 全部 skill

npx skills add swarmclawai/swarmclaw --all -g -y

预览 repo 内 skill

npx skills add swarmclawai/swarmclaw --list

SKILL.md

Frontmatter

{
    "name": "github",
    "metadata": {
        "openclaw": {
            "emoji": "🐙",
            "install": [
                {
                    "id": "brew",
                    "bins": [
                        "gh"
                    ],
                    "kind": "brew",
                    "label": "Install GitHub CLI (brew)",
                    "formula": "gh"
                },
                {
                    "id": "apt",
                    "bins": [
                        "gh"
                    ],
                    "kind": "apt",
                    "label": "Install GitHub CLI (apt)",
                    "package": "gh"
                }
            ],
            "requires": {
                "bins": [
                    "gh"
                ]
            }
        }
    },
    "description": "GitHub operations via `gh` CLI: issues, PRs, CI runs, code review, API queries. Use when: (1) checking PR status or CI, (2) creating\/commenting on issues, (3) listing\/filtering PRs or issues, (4) viewing run logs. NOT for: local git operations (use git directly), non-GitHub repos, or cloning (use git clone)."
}

GitHub Skill

Use the gh CLI to interact with GitHub repositories, issues, PRs, and CI.

Setup

# Authenticate (one-time)
gh auth login

# Verify
gh auth status

Common Commands

Pull Requests

# List PRs
gh pr list --repo owner/repo

# Check CI status
gh pr checks 55 --repo owner/repo

# View PR details
gh pr view 55 --repo owner/repo

# Create PR
gh pr create --title "feat: add feature" --body "Description"

# Merge PR
gh pr merge 55 --squash --repo owner/repo

Issues

# List issues
gh issue list --repo owner/repo --state open

# Create issue
gh issue create --title "Bug: something broken" --body "Details..."

# Close issue
gh issue close 42 --repo owner/repo

CI/Workflow Runs

# List recent runs
gh run list --repo owner/repo --limit 10

# View specific run
gh run view <run-id> --repo owner/repo

# View failed step logs only
gh run view <run-id> --repo owner/repo --log-failed

# Re-run failed jobs
gh run rerun <run-id> --failed --repo owner/repo

API Queries

# Get PR with specific fields
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

# List all labels
gh api repos/owner/repo/labels --jq '.[].name'

# Get repo stats
gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

JSON Output

Most commands support --json for structured output with --jq filtering:

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
gh pr list --json number,title,state,mergeable --jq '.[] | select(.mergeable == "MERGEABLE")'

Templates

PR Review Summary

PR=55 REPO=owner/repo
echo "## PR #$PR Summary"
gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \
  --jq '"**\(.title)** by @\(.author.login)\n\n\(.body)\n\n+\(.additions) -\(.deletions) across \(.changedFiles) files"'
gh pr checks $PR --repo $REPO

Issue Triage

gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \
  --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'