How do I install the Github skill?

Run npx skillmds@latest add jst-well-dan/github in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github?

Jst-Well-Dan (@jst-well-dan) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github by jst-well-dan — Agent Skill

Name: Github
Rating: 4.2 (5 reviews)
Author: Jst-Well-Dan

Github

通过 `gh` CLI 执行 GitHub 操作：管理 Issue、PR、CI 运行、代码审查、API 查询。适用于：(1) 检查 PR 状态或 CI 情况, (2) 创建或评论 Issue, (3) 列出/筛选 PR 或 Issue, (4) 查看运行日志。不适用于：需要手动浏览器操作的复杂 Web UI 交互（如果可用，请使用浏览器工具）、跨多个仓库的批量操作（使用 gh api 脚本），或者未配置 gh auth 的情况。

Jst-Well-Dan Updated Sep 10, 2026

File contents

GitHub 操作技能

使用 gh CLI 与 GitHub 仓库、Issue、PR 和 CI 进行交互。

何时使用

✅ 在以下情况下使用此技能：

检查 PR 状态、审查情况或合并就绪状态。
查看 CI/工作流运行状态和日志。
创建、关闭或评论 Issue。
创建或合并拉取请求 (Pull Requests)。
查询 GitHub API 获取仓库数据。
列出仓库、发布版本或协作者。

何时不要使用

❌ 在以下情况下不要使用此技能：

本地 git 操作（commit, push, pull, branch）→ 直接使用 git。
非 GitHub 仓库（GitLab, Bitbucket, 自托管等）→ 使用不同的 CLI。
克隆仓库 → 使用 git clone。
审查实际的代码更改 → 使用 coding-agent 技能。
复杂的跨文件差异比较 → 使用 coding-agent 或直接读取文件。

设置指南

# 身份验证（一次性设置）
gh auth login

# 验证状态
gh auth status

常用命令

拉取请求 (Pull Requests)

# 列出 PR
gh pr list --repo owner/repo

# 检查 CI 状态
gh pr checks 55 --repo owner/repo

# 查看 PR 详情
gh pr view 55 --repo owner/repo

# 创建 PR
gh pr create --title "feat: 添加功能" --body "描述内容"

# 合并 PR
gh pr merge 55 --squash --repo owner/repo

问题 (Issues)

# 列出 Issue
gh issue list --repo owner/repo --state open

# 创建 Issue
gh issue create --title "Bug: 某些功能损坏" --body "详情描述..."

# 关闭 Issue
gh issue close 42 --repo owner/repo

CI/工作流运行 (Workflow Runs)

# 列出最近的运行记录
gh run list --repo owner/repo --limit 10

# 查看特定运行记录
gh run view <run-id> --repo owner/repo

# 仅查看失败步骤的日志
gh run view <run-id> --repo owner/repo --log-failed

# 重新运行失败的作业
gh run rerun <run-id> --failed --repo owner/repo

API 查询

# 获取带特定字段的 PR 信息
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

# 列出所有标签
gh api repos/owner/repo/labels --jq '.[].name'

# 获取仓库统计数据
gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

JSON 输出

大多数命令支持 --json 参数以获得结构化输出，配合 --jq 进行筛选：

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

模板示例

PR 审查摘要

# 获取 PR 概览用于审查
PR=55 REPO=owner/repo
echo "## PR #$PR 摘要"
gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \
  --jq '"**\(.title)** 由 @\(.author.login) 提交\n\n\(.body)\n\n📊 +\(.additions) -\(.deletions) 涉及 \(.changedFiles) 个文件"'
gh pr checks $PR --repo $REPO

Issue 分类整理

# 快速 Issue 分类视图
gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \
  --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'

注意事项

不在 git 目录中时，务必指定 --repo owner/repo。
直接使用 URL：gh pr view https://github.com/owner/repo/pull/55。
存在速率限制；对于重复查询，请使用 gh api --cache 1h。

---name: githubdescription: 通过 `gh` CLI 执行 GitHub 操作：管理 Issue、PR、CI 运行、代码审查、API 查询。适用于：(1) 检查 PR 状态或 CI 情况, (2) 创建或评论 Issue, (3) 列出/筛选 PR 或 Issue, (4) 查看运行日志。不适用于：需要手动浏览器操作的复杂 Web UI 交互（如果可用，请使用浏览器工具）、跨多个仓库的批量操作（使用 gh api 脚本），或者未配置 gh auth 的情况。---# GitHub 操作技能使用 `gh` CLI 与 GitHub 仓库、Issue、PR 和 CI 进行交互。## 何时使用✅ **在以下情况下使用此技能：**- 检查 PR 状态、审查情况或合并就绪状态。- 查看 CI/工作流运行状态和日志。- 创建、关闭或评论 Issue。- 创建或合并拉取请求 (Pull Requests)。- 查询 GitHub API 获取仓库数据。- 列出仓库、发布版本或协作者。## 何时不要使用❌ **在以下情况下不要使用此技能：**- 本地 git 操作（commit, push, pull, branch）→ 直接使用 `git`。- 非 GitHub 仓库（GitLab, Bitbucket, 自托管等）→ 使用不同的 CLI。- 克隆仓库 → 使用 `git clone`。- 审查实际的代码更改 → 使用 `coding-agent` 技能。- 复杂的跨文件差异比较 → 使用 `coding-agent` 或直接读取文件。## 设置指南```bash# 身份验证（一次性设置）gh auth login# 验证状态gh auth status```## 常用命令### 拉取请求 (Pull Requests)```bash# 列出 PRgh pr list --repo owner/repo# 检查 CI 状态gh pr checks 55 --repo owner/repo# 查看 PR 详情gh pr view 55 --repo owner/repo# 创建 PRgh pr create --title "feat: 添加功能" --body "描述内容"# 合并 PRgh pr merge 55 --squash --repo owner/repo```### 问题 (Issues)```bash# 列出 Issuegh issue list --repo owner/repo --state open# 创建 Issuegh issue create --title "Bug: 某些功能损坏" --body "详情描述..."# 关闭 Issuegh issue close 42 --repo owner/repo```### CI/工作流运行 (Workflow Runs)```bash# 列出最近的运行记录gh run list --repo owner/repo --limit 10# 查看特定运行记录gh run view <run-id> --repo owner/repo# 仅查看失败步骤的日志gh run view <run-id> --repo owner/repo --log-failed# 重新运行失败的作业gh run rerun <run-id> --failed --repo owner/repo```### API 查询```bash# 获取带特定字段的 PR 信息gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'# 列出所有标签gh api repos/owner/repo/labels --jq '.[].name'# 获取仓库统计数据gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'```## JSON 输出大多数命令支持 `--json` 参数以获得结构化输出，配合 `--jq` 进行筛选：```bashgh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'gh pr list --json number,title,state,mergeable --jq '.[] | select(.mergeable == "MERGEABLE")'```## 模板示例### PR 审查摘要```bash# 获取 PR 概览用于审查PR=55 REPO=owner/repoecho "## PR #$PR 摘要"gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \ --jq '"**\(.title)** 由 @\(.author.login) 提交\n\n\(.body)\n\n📊 +\(.additions) -\(.deletions) 涉及 \(.changedFiles) 个文件"'gh pr checks $PR --repo $REPO```### Issue 分类整理```bash# 快速 Issue 分类视图gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \ --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'```## 注意事项- 不在 git 目录中时，务必指定 `--repo owner/repo`。- 直接使用 URL：`gh pr view https://github.com/owner/repo/pull/55`。- 存在速率限制；对于重复查询，请使用 `gh api --cache 1h`。

Frequently asked questions