using-github-mcp
Use when choosing the right GitHub or Git surface for a task, picking between the GitHub MCP server, gh CLI, REST API, GraphQL, or plain git commands.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- using-github-mcp
- license
- MIT
- metadata
- { "owner": "Harley Bartles", "status": "active", "use_when": [ "choosing the right GitHub or Git surface for a task, picking between the GitHub MCP server, gh CLI, REST API, GraphQL, or plain git commands." ], "source-id": "using-github-mcp", "source-path": "skills/using-github-mcp/SKILL.md", "do_not_use_when": [ "another more specific skill owns this task." ], "provenance-name": "Using GitHub MCP first-party skill", "source-category": "first_party" }
- description
- Use when choosing the right GitHub or Git surface for a task, picking between the GitHub MCP server, gh CLI, REST API, GraphQL, or plain git commands.
02 资源文件 12
- 参考文档agents/openai.yaml487 B
- 资产文件assets/icon.svg1.7 KB
- 参考文档references/commits-branches.md3.5 KB
- 参考文档references/gh-cli.md1.6 KB
- 参考文档references/graphql.md2.3 KB
- 参考文档references/issues-comments.md2.6 KB
- 参考文档references/mcp-surface.md3.4 KB
- 参考文档references/mutations.md4.0 KB
- 参考文档references/pull-requests.md2.8 KB
- 参考文档references/read-discover.md3.5 KB
- 参考文档references/reviews.md3.3 KB
- 参考文档references/surface-map.md8.8 KB
03 SKILL.md 正文
Using GitHub MCP
Use this skill to pick the right GitHub or Git surface from the task intent, then open the matching reference.
Runtime availability
Inspect the tools exposed in the current runtime before choosing MCP. This guidance is available independently of repository subscriptions. If a needed MCP operation is absent, use the documented gh, REST, GraphQL, or Git alternative only when that surface is available and suitable; otherwise report the missing capability and stop the dependent action.
Router
| Intent | Read first |
|---|---|
| Search, list, or read repositories, files, commits, branches, tags, or releases | references/read-discover.md |
| Create, update, merge, or review pull requests | references/pull-requests.md |
| Read or write PR reviews, review threads, and inline review comments | references/reviews.md |
| Read or write issues and issue/PR timeline comments | references/issues-comments.md |
| Work with commits, branches, tags, or low-level git refs | references/commits-branches.md |
| Create, update, or delete files, repositories, labels, or other mutations | references/mutations.md |
| Run a GitHub GraphQL query or mutation | references/graphql.md |
Use the gh command-line interface |
references/gh-cli.md |
| Pick the right GitHub MCP tool | references/mcp-surface.md |
| Need the complete callable surface | references/surface-map.md |
Fast rule
If you need exact current repository state, prefer gh api or gh api graphql. If the intent is still unclear after the first pass, open references/surface-map.md and return to the use-case file that matches the object you are touching.
Before changing a PR's draft state, discover and follow the consuming repository's declared PR policy at its own path. If no applicable local policy is declared, use the portable policy in the pull-request guidance.
04 同仓库更多 Skills
writing
Use when drafting, revising, or reviewing prose for human readers and clarity, an authorised voice, or reader-fatigue concerns may interact.
writing-with-clarity
Use when drafting, revising, or reviewing prose intended for human readers, including documentation, README files, reports, explanations, UI copy, errors, comments, commit messages, and pull request text.
writing-style
Use when revising or reviewing human-facing prose against an authorised voice card or a contextual reader-fatigue profile.
skill
暂无简介
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
writing-roadmaps
Use when a goal is too large for one writing-plans plan and requires a sequenced roadmap of consecutive plans.