github-operations
**WORKFLOW SKILL** — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases. gh CLI-first with MCP fallback. WHEN: "commit", "push", "open PR", "create branch", "create issue", "cut release", "GitHub operation". DO NOT USE FOR: Azure infrastructure, Bicep/Terraform code, architecture decisions. INVOKES: gh CLI (primary), GitHub MCP (fallback).
git clone --depth 1 https://github.com/jonathan-vella/apex /tmp/github-operations && cp -r /tmp/github-operations/.github/skills/github-operations ~/.claude/skills/github-operationsSKILL.md
# GitHub Operations Full contribution lifecycle — from branch creation to PR merge. `gh` CLI preferred (always available in this dev container); MCP tools as fallback for operations with no `gh` equivalent (rich PR review thread management, bulk GraphQL queries). ## Steps ```text 1. Create branch (naming convention) → 2. Make changes → 3. Commit (conventional commits) → 4. Push (pre-push hooks validate branch + scope) → 5. Create PR (gh CLI) → 6. Review + Merge ``` ## Rules 1. **Identify the operation** (issue, PR, search, Actions, release, etc.) 2. **Use `gh` CLI by default** — always available in this dev container; the more stable primitive 3. **Fall back to MCP only** when `gh` cannot satisfy the operation (rich PR review threads, bulk GraphQL, Copilot review requests) 4. **Validate branch name before any commit or PR** — `git rev-parse --abbrev-ref HEAD`; if invalid, stop and rename via `git branch -m` 5. **Conventional Commits are mandatory** — enforced by commitlint 6. **Devcontainer**: do not run `gh auth login`; `GH_TOKEN` is set via VS Code User Settings (`terminal.integrated.env.linux`) 7. **Never skip hooks** (`--no-verify`) unless the user explicitly asks ## Branch Naming Quick Reference | Type | Prefixes | File Scope | | ------------- | ------------------------------------------------------------------------------------ | -------------------------- | | Domain-scoped | `docs/`, `agents/`, `skills/`, `infra/`, `scripts/`, `instructions/` | Restricted to domain paths | | Cross-cutting | `feat/`, `fix/`, `chore/`, `ci/`, `refactor/`, `perf/`, `test/`, `build/`, `revert/` | Any files | For scope tables, validation commands, and enforcement layers, read [`references/branch-strategy.md`](references/branch-strategy.md). ## Conventional Commits Quick Reference Format: `<type>[optional scope]: <description>`. Types: `feat`, `fix`, `docs`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`. Scopes: `agents`, `skills`, `instructions`, `bicep`, `terraform`, `mcp`, `docs`, `scripts`. For staging, breaking changes, and safety protocol, read [`references/commit-conventions.md`](references/commit-conventions.md). ## Issues & Pull Requests `gh issue ...` and `gh pr ...` are the default for both. MCP tools are available as a fallback for operations the CLI does not cover well (rich PR review threads, Copilot review requests, bulk GraphQL). > **Default merge method**: `squash` unless the user specifies otherwise. For tool tables, creation pre-flight checks, and the gh-vs-MCP decision lattice, read [`references/issues-and-prs.md`](references/issues-and-prs.md). For PR lifecycle states, auto-labels, and auto-merge conditions, read [`references/smart-pr-flow.md`](references/smart-pr-flow.md). ## CLI Commands For complete `gh` CLI commands covering repos, Actions, releases, secrets, API, and auth, read [`references/detailed-commands.md`](references/detailed-commands.md). > **IMPORTANT**: `gh api -f` does not support object values. Use multiple > `-f` flags with hierarchical keys and string values instead. ### Global Flags | Flag | Description | | ------------------- | -------------------------- | | `--repo OWNER/REPO` | Target specific repository | | `--json FIELDS` | Output JSON with fields | | `--jq EXPRESSION` | Filter JSON output | | `--web` | Open in browser | | `--paginate` | Fetch all pages | ## Smart PR Flow Quick Reference | Condition | Label Applied | | --------------------------- | -------------------- | | CI passes | `infraops-ci-pass` | | CI fails | `infraops-needs-fix` | | Review approved | `infraops-reviewed` | | Auto-merge (all gates pass) | PR merged via MCP | Full state machine, watchdog pattern, and auto-merge gates in [`references/smart-pr-flow.md`](references/smart-pr-flow.md). ## Reference Index | Reference | File | Content | | ------------------ | ---------------------------------- | --------------------------------------------------- | | Branch Strategy | `references/branch-strategy.md` | Naming convention, scope tables, enforcement layers | | Commit Conventions | `references/commit-conventions.md` | Format, types, staging workflow, safety protocol | | Issues & PRs | `references/issues-and-prs.md` | gh-vs-MCP decision lattice, tool tables, pre-flight | | Smart PR Flow | `references/smart-pr-flow.md` | PR lifecycle states, auto-labels, auto-merge | | CLI Commands | `references/detailed-commands.md` | Repos, Actions, Releases, Secrets, API, Auth |
Guidance for instrumenting webapps with Azure Application Insights. Provides telemetry patterns, SDK setup, and configuration references. WHEN: how to instrument app, App Insights SDK, telemetry patterns, what is App Insights, Application Insights guidance, instrumentation examples, APM best practices.
Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.
Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailbreak detection, add Azure OpenAI backend, add AI Foundry model, test AI gateway, LLM policies, configure AI backend, token metrics, AI cost control, convert API to MCP, import OpenAPI to gateway.
ROUTING SKILL — delegates to specialized diagram skills. USE FOR: any diagram request when the caller does not know which tool to use. Routes to drawio, python-diagrams, or mermaid based on diagram type.
Build and deploy GitHub Copilot SDK apps to Azure. WHEN: build copilot app, create copilot app, copilot SDK, @github/copilot-sdk, scaffold copilot project, copilot-powered app, deploy copilot app, host on azure, azure model, BYOM, bring your own model, use my own model, azure openai model, DefaultAzureCredential, self-hosted model, copilot SDK service, chat app with copilot, copilot-sdk-service template, azd init copilot, CopilotClient, createSession, sendAndWait, GitHub Models API.
Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. WHEN: event hub SDK error, service bus SDK issue, messaging connection failure, AMQP error, event processor host issue, message lock lost, send timeout, receiver disconnected, SDK troubleshooting, azure messaging SDK, event hub consumer, service bus queue issue, topic subscription error, enable logging event hub, service bus logging, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, event hub checkpoint, event hub not receiving messages, service bus dead letter.
Authoritative reference for VS Code Copilot customization mechanisms: instructions, prompt files, custom agents, agent skills, MCP servers, hooks, and plugins. Use when deciding which customization type to use, creating new .instructions.md/.prompt.md/.agent.md/SKILL.md/mcp.json files from scratch, or debugging why a customization is not loading. DO NOT USE FOR: routine file edits where the format is already known.
Provides canonical entity counts from count-manifest.json. Use when agents need to reference how many agents, skills, instructions, or validators exist. Prevents hard-coded counts. WHEN: agent count, skill count, how many agents, how many skills, entity inventory, project statistics.