| name | api-github |
| description | GitHub REST API for issues, PRs, repos. Uses PAT for headless/CI. Activate for GitHub operations. |
| allowed-tools | Bash, Read, Grep |
| user-invocable | true |
| quality_grade | B |
| quality_checked | "2026-03-19T00:00:00.000Z" |
GitHub API Skill
When to Activate
- Create/read/update issues
- Manage pull requests
- Query repository information
- Access GitHub Actions status
Authentication
Credentials File: .credentials/github.json
{
"personal_access_token": "ghp_..."
}
Create token at: https://github.com/settings/tokens
Required scopes:
repo - Full repository access
workflow - GitHub Actions (optional)
Load credentials before API calls:
GITHUB_TOKEN=$(jq -r '.personal_access_token' /Users/dhlee/Git/personal/neuron/.credentials/github.json)
API Base URL
https://api.github.com
Common Operations
Get Authenticated User
curl -s -H "Authorization: Bearer $GITHUB_TOKEN" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/user
List Repository Issues
curl -s -H "Authorization: Bearer $GITHUB_TOKEN" \
-H "X-GitHub-Api-Version: 2022-11-28" \
"https://api.github.com/repos/{owner}/{repo}/issues?state=open"
Create Issue
curl -s -X POST \
-H "Authorization: Bearer $GITHUB_TOKEN" \
-H "X-GitHub-Api-Version: 2022-11-28" \
-H "Content-Type: application/json" \
-d '{"title":"Issue title","body":"Issue body","labels":["bug"]}' \
https://api.github.com/repos/{owner}/{repo}/issues
Get Pull Request
curl -s -H "Authorization: Bearer $GITHUB_TOKEN" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/repos/{owner}/{repo}/pulls/{pr_number}
Create Pull Request
curl -s -X POST \
-H "Authorization: Bearer $GITHUB_TOKEN" \
-H "X-GitHub-Api-Version: 2022-11-28" \
-H "Content-Type: application/json" \
-d '{"title":"PR title","body":"PR body","head":"feature-branch","base":"main"}' \
https://api.github.com/repos/{owner}/{repo}/pulls
Error Handling
| Status | Meaning | Action |
|---|
| 401 | Invalid token | Check .credentials/github.json |
| 403 | Rate limit or scope | Wait or check permissions |
| 404 | Not found or no access | Verify repo/resource exists |
Rate Limits
- Authenticated: 5,000 requests/hour
- Check:
X-RateLimit-Remaining header
References