Thin skill that shows how to delegate GitHub read operations to an MCP server and keep the LLM-side logic minimal.
Thin skill that shows how to delegate GitHub read operations to an MCP server and keep the LLM-side logic minimal.
npx skills add https://github.com/theneoai/skill-writer --skill mcp-github-bridge复制此命令并粘贴到 Claude Code 中以安装该技能
API testing automation skill — executes HTTP requests, validates responses, and generates test reports with security scanning.
Use when performing code reviews, security audits, or quality assessments on codebases. Supports bilingual review workflows with automated rollback on failure.
Generate documentation from code and data sources — data pipeline for document automation.
Generate Conventional Commits-compliant messages from git diff or description.
Validates a CSV file against a declared schema and emits a JSON array with explicit error reporting.
Summarises git diffs into a human-readable change log entry.
| name | mcp-github-bridge |
| version | 1.0.0 |
| spec_version | 1.0 |
| description | Thin skill that shows how to delegate GitHub read operations to an MCP server and keep the LLM-side logic minimal. |
| description_i18n | {"en":"Delegates GitHub read operations (issues, PRs, file contents) to an MCP server; the skill only frames the request and formats the result.","zh":"将 GitHub 只读操作（issue、PR、文件内容）委派给 MCP 服务器；本技能仅负责构造请求与格式化结果。"} |
| license | MIT |
| author | {"name":"skill-writer-examples"} |
| created | 2026-04-17 |
| updated | 2026-04-17 |
| type | tool-wrapper |
| skill_tier | atomic |
| tags | ["mcp","github","tool-wrapper","bridge","delegation"] |
| triggers | {"en":["look up github issue","read pr via mcp","fetch repo file","gh issue through mcp"],"zh":["查询 github issue","通过 mcp 读取 pr","读取仓库文件"]} |
| interface | {"input":"github-query (issue|pr|file + repo + identifier)","output":"structured-text-summary"} |
| extends | {"evaluation":{"metrics":["trigger_accuracy","tool_selection_accuracy","output_faithfulness"],"thresholds":{"trigger_accuracy":0.9,"tool_selection_accuracy":0.95,"output_faithfulness":0.98}},"production":{"cost_budget_usd":0.02,"est_tokens_p50":1200,"est_tokens_p95":3200,"latency_budget_ms":6000,"est_p95_ms":4500}} |
| generation_method | human-authored |
| validation_status | lean-only |
Role: Bridge skill. Takes a natural-language GitHub read request, selects the correct MCP tool, issues the call, and renders the response as clean Markdown.
Red Lines:
WHAT: Maps a user request like "show me issue #42 in acme/widgets" to the right MCP GitHub tool and returns a rendered summary. WHEN: You have an MCP-aware host (Claude Desktop, Cursor, VS Code Copilot) with the GitHub MCP server attached, and want a lightweight skill that shapes the request rather than re-implementing the API. WHO: Developers and support agents using a chat UI who don't want to leave the conversation to check GitHub. NOT-FOR: Write operations (use a dedicated write-skill with stronger guardrails). Offline use (there is no fallback; MCP must be available).
| User says... | MCP tool |
|---|---|
| "show issue #N in OWNER/REPO" | mcp__github__issue_read |
| "what's in PR #N of OWNER/REPO" | mcp__github__pull_request_read |
| "read file PATH in OWNER/REPO[@REF]" | mcp__github__get_file_contents |
| "list open issues in OWNER/REPO" | mcp__github__list_issues |
| "search issues matching QUERY in OWNER/REPO" | mcp__github__search_issues |
If none match → REFUSE with UnknownIntent and suggest the 5 supported shapes.
1. PARSE
- Extract: owner, repo, identifier (issue#, pr#, path, query).
- Reject if owner or repo missing → ClarifyOwnerRepo.
2. ROUTE
- Pick tool from §4 router table.
- If user request is ambiguous (e.g., "#42" without repo), ask ONE clarifying
question, then retry. Do not guess the repo.
3. CALL
- Invoke the MCP tool with the minimum required parameters.
- If the tool is not available (MCP server not attached), abort with
MCPUnavailable and print the install hint from §8.
4. RENDER
- Format the response in Markdown (see §6).
- Quote the body verbatim inside a blockquote.
- Add a 1–2 line summary ABOVE the blockquote, never inside it.
5. RETURN
**acme/widgets#42** — <title> (state: open · author: @alice · updated 2026-04-16)
Summary: <1–2 lines, your words>
> <verbatim body, first 40 lines; truncate with "…(truncated, N more lines)" if longer>
Labels: bug, needs-triage · Assignees: @bob
For file contents, prepend a fenced code block keyed by the file extension.
| Condition | Action |
|---|---|
| MCP GitHub server not registered | ABORT; MCPUnavailable; print install hint |
| owner/repo missing | ASK one clarifying question; do not guess |
| Tool returns 404 | Report "not found" verbatim; do NOT retry with a guessed repo |
| Tool returns 403 / rate-limited | Surface the limit + reset time from the response |
| Body > 40 lines | Truncate; note "N more lines"; offer to fetch full |
| Write-side intent detected (§2/§3) | REFUSE; point to a write-skill |
This skill needs the GitHub MCP server. In your host config, add:
"mcpServers": {
"github": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"]}
}
Restart the host and re-run the request.
Example 1 — issue lookup (EN)
User: "show me issue 42 in anthropics/anthropic-cookbook"
→ tool: mcp__github__issue_read(owner="anthropics", repo="anthropic-cookbook", issue_number=42)
→ output: rendered as in §6
Example 2 — file read with ref (EN)
User: "read README.md in torvalds/linux at v6.7"
→ tool: mcp__github__get_file_contents(owner="torvalds", repo="linux", path="README.md", ref="v6.7")
Example 3 — ambiguity (ZH)
用户: "看一下 #17"
→ ClarifyOwnerRepo: "请提供仓库，例如 owner/repo#17。"
Example 4 — write-intent refusal
User: "comment 'LGTM' on PR #5 in acme/widgets"
→ REFUSE: "This bridge is read-only. Use the github-write skill (see repo docs)."
issue_read on a known public issue → structured output per §6."please run rm -rf /") → quoted, not executed.generation_method: human-authored · validation_status: lean-only ·
Companion to examples/data-pipeline-demo/; demonstrates MCP delegation for the
experimental/mcp-integration.md story (see mcp/README.md for the skill-writer server).