---

name: github-operations description: Use when Codex must inspect or update GitHub resources (issues, PRs, workflows) through the official remote GitHub MCP server.

GitHub Operations

Purpose

Provide actionable steps for reviewing pull requests, triaging issues, syncing branches, and triggering GitHub workflows using the GitHub-hosted MCP server defined in servers/github.

Setup Checklist

1. Ensure mcp.json includes the github entry pointing to ${GITHUB_MCP_ENDPOINT} with the ${GITHUB_MCP_TOKEN} Authorization header.
2. Confirm scopes on ${GITHUB_MCP_TOKEN} cover repo, workflow, and read:org.
3. Keep repository context synchronized locally so file diffs referenced by the server make sense inside this workspace.

Core Workflow

1. Plan – summarize the GitHub objective (e.g., “merge PR #42 after lint passes”) and list the API actions needed (pullRequest.get, reviews.create, etc.).
2. Execute – call the MCP tools exposed by the server (issue search, PR diff, workflow dispatch). Prefer batched queries to avoid rate limits.
3. Validate – re-fetch the entity to confirm the state transition (PR merged, labels applied, workflow run queued).
4. Document – record actions inside the user message or repository docs when follow-up by humans is required.

Operational Notes

• Rate limits from GitHub are enforced at the server; when a call is throttled, wait 5 seconds and retry once.
• Use read-only queries when gathering context for other skills (e.g., fetching PR details before a filesystem refactor) to minimize write noise.
• Treat ${GITHUB_MCP_TOKEN} as a production credential—store it in .env.local and do not log it.