github-index - SKILL.md Agent Skill

name: github-index description: >- Top-level intent router for GitHub operations. Routes auth requests to github-auth, repo/PR/issue operations to the cli-operator agent, and CI/CD watching to existing gh tools. Use when the user mentions GitHub, gh CLI, repos, PRs, issues, actions, or any GitHub topic but the request does not clearly match a specific skill trigger. user-invocable: false

GitHub Intent Router

Route the user's request to the correct skill or agent.

Routing Rules

Authentication

Keywords: "login", "authenticate", "gh auth", "GitHub login", "token", "connect GitHub"

Auth setup -> invoke github:github-auth skill

Auth status check -> delegate to github:cli-operator agent:

Agent(
  subagent_type="github:cli-operator",
  description="Check GitHub auth status",
  prompt="Run gh auth status and report the authenticated user, active account, and token scopes."
)

Repository and PR Operations

Keywords: "repo", "repository", "pull request", "PR", "issue", "merge", "review", "diff", "checkout", "branch"

Delegate to the cli-operator agent:

Agent(
  subagent_type="github:cli-operator",
  description="<brief description of the operation>",
  prompt="<specific gh CLI commands to execute and what to report>"
)

Common patterns:

Topic	Example delegation prompt
View repo info	`Run gh repo view --json nameWithOwner,description,url and report the details.`
List PRs	`Run gh pr list --json number,title,state,author and format as a table.`
View a PR	`Run gh pr view <number> --json title,body,state,reviews and summarize.`
PR diff	`Run gh pr diff <number> and summarize the changes.`
Checkout PR	`Run gh pr checkout <number> and confirm the branch switch.`
List issues	`Run gh issue list --json number,title,state,labels and format as a table.`
View an issue	`Run gh issue view <number> --json title,body,state,comments and summarize.`
Search	`Run gh search repos <query> --json fullName,description,stars and report top results.`

CI/CD and Actions

Keywords: "actions", "workflow", "run", "CI", "CD", "build", "pipeline", "checks"

Watching a run -> delegate to cli-operator agent or use the existing gh_run_watch tool if available

Listing workflows -> delegate to cli-operator agent:

Agent(
  subagent_type="github:cli-operator",
  description="List GitHub Actions workflow runs",
  prompt="Run gh run list --json databaseId,displayTitle,status,conclusion,headBranch --limit 10 and format as a table."
)

Generic gh Commands

For any gh CLI command not covered above, delegate to the cli-operator agent with the specific command:

Agent(
  subagent_type="github:cli-operator",
  description="Execute gh CLI command",
  prompt="Run: <the user's requested gh command>. Report the output."
)

Important Notes

The GitHub plugin provides native MCP tools for common operations (gh_repo_view, gh_pr_view, gh_issue_view, etc.) that activate automatically
This router handles cases that fall outside the native tools
Always check authentication before performing operations