// Handles GitHub issues, pull requests, repositories, Actions, releases, and API tasks using MCP-first workflows with gh CLI fallback for advanced operations.
Creates Azure Architecture Decision Records (ADRs) with WAF mapping, alternatives, consequences, and implementation guidance; use for architecture decision documentation requests.
Defines canonical artifact templates, H2 structures, and documentation styling rules for agent outputs (Steps 1-7); use for artifact generation, formatting, and template compliance.
Provides Azure defaults for naming, regions, tags, AVM-first modules, security baselines, WAF criteria, governance discovery, and pricing guidance across all agents.
Azure resource troubleshooting patterns including KQL templates, metric thresholds, health checks, and remediation playbooks. Use when diagnosing unhealthy Azure resources or building diagnostic workflows.
Maintains repository documentation accuracy and freshness; use for doc updates, agent or skill changes, staleness checks, changelog entries, and repo explanation requests.
HackOps platform business rules, role matrix, lifecycle states, and scoring invariants. Use when building API routes, writing tests, or validating business logic for the HackOps hackathon management platform. Keywords: hackathon, team, coach, hacker, admin, rubric, scoring, leaderboard, event code, progression.
| name | github-operations |
| description | Handles GitHub issues, pull requests, repositories, Actions, releases, and API tasks using MCP-first workflows with gh CLI fallback for advanced operations. |
| license | MIT |
| metadata | {"author":"hack-ops","version":"3.0","category":"github"} |
Manage all GitHub operations using MCP tools (preferred) and GitHub CLI (fallback).
MCP-first: Use MCP tools for issues and PRs — no extra auth, works everywhere. CLI fallback: Use
ghCLI for Actions, releases, repos, secrets, and API calls.
| File | When to Load |
|---|---|
references/mcp-tools.md | Creating/managing issues and pull requests via MCP |
references/gh-cli.md | Actions, releases, repos, secrets, API — CLI fallback |
Follow this protocol for every GitHub task:
gh CLI only when no equivalent MCP write tool is availablegh auth login or gh auth status in devcontainer workflows
unless the user explicitly asks for CLI auth troubleshooting.| Operation | Tool | Reference |
|---|---|---|
| Create/read/update issues | MCP (mcp_github_issue_write, mcp_github_issue_read) | references/mcp-tools.md |
| Search issues | MCP (mcp_github_search_issues) | references/mcp-tools.md |
| Create/merge/review PRs | MCP (mcp_github_create_pull_request, etc.) | references/mcp-tools.md |
| List/search PRs | MCP (mcp_github_list_pull_requests, etc.) | references/mcp-tools.md |
| Repo create/clone/fork | gh repo | references/gh-cli.md |
| Workflow run/list/watch | gh workflow, gh run | references/gh-cli.md |
| Releases | gh release | references/gh-cli.md |
| Secrets & variables | gh secret, gh variable | references/gh-cli.md |
| REST/GraphQL API | gh api | references/gh-cli.md |
| Labels | gh label | references/gh-cli.md |
| Search code/repos | gh search | references/gh-cli.md |
gh CLI for Actions, releases, repos, secrets, APIgh CLI for issues/PRs when MCP tools are availablegh auth flows in devcontainers unless explicitly requested