GitHub
Read pull requests, issues and CI checks via GitHub REST API.
SKILL.mdskills/github/SKILL.md
GitHubGitHub
Use this skill for repository operations: pull requests, issues, CI checks.
Backed by the github extension which calls the GitHub REST API directly with
a Personal Access Token. No gh CLI dependency.
Use when
- "List open PRs in <repo>"
- "Show details of PR 123"
- "Check CI status of PR 7"
- "List open issues"
Do not use when
- Cloning, committing, or pushing code → use
gitdirectly - Creating PRs / issues (write operations) → not exposed in this version
- Searching across many repos → REST search is not exposed; ask the user to use the GitHub UI
Tools
status
No arguments. Returns whether GITHUB_TOKEN is set and, if so, the
authenticated user.
pr_list
repo(string) —owner/repo. Falls back toGITHUB_DEFAULT_REPO.state(string, optional) —open|closed|all. Defaultopen.limit(integer, optional) — 1–100, default 20.
Returns {repo, state, limit, count, pulls: [{number, title, state, draft, user, head_sha, base_ref, html_url, created_at, updated_at}]}.
pr_view
repo(string, optional)number(integer, required)
Returns the raw GitHub PR object.
pr_checks
repo(string, optional)number(integer, required)
Two-step: fetches the PR to get the head SHA, then fetches check-runs.
Returns {repo, number, head_sha, checks: {total_count, check_runs: [...]}}.
issue_list
repo(string, optional)state(string, optional)limit(integer, optional, 1–100)
Returns issues with PRs filtered out (pull_request field absent).
Execution guidance
- Start with
statusif uncertain about auth (verifies token + lists default repo). - If error code is
-32011(unauthorized) →GITHUB_TOKENis missing or invalid; ask the operator. - If
-32013(rate limited) → wait until thereset_atepoch in the message. - Pass explicit
repoonly when different fromGITHUB_DEFAULT_REPO. - Prefer
pr_checksoverpr_viewwhen the user asks "what is failing in PR X".