Azv Bicep Diagram Sync
Azure/AZVerify
Compare Bicep templates against a Draw.io Azure architecture diagram to detect resource-level divergence.
WORKFLOW SKILL — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases.
Install Apex GitHub Operations
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jonathan-vella/apex apex-github-operations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/apex-github-operations .claude/skills/apex-github-operations && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .claude/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jonathan-vella/apex apex-github-operations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/apex-github-operations .agents/skills/apex-github-operations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .agents/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jonathan-vella/apex apex-github-operations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/apex-github-operations .cursor/skills/apex-github-operations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .cursor/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jonathan-vella/apex.git --path .github/skills/apex-github-operations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jonathan-vella/apex apex-github-operations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/apex-github-operations .gemini/skills/apex-github-operations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .gemini/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jonathan-vella/apex apex-github-operationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/apex-github-operations .github/skills/apex-github-operations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .github/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jonathan-vella/apex --skill apex-github-operations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jonathan-vella/apex apex-github-operations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/apex-github-operations .opencode/skills/apex-github-operations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "apex-github-operations" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-github-operations into .opencode/skills/apex-github-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-github-operations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
apex-github-operations- GitHub stars
- 217
- Token cost
- ~1.5k tokens
- SKILL.md length
- 475 words
- Files
- 8 (incl. references)
- Skills in repo
- 39
- Repo updated
- First seen
- Licence
- MIT
At a glance
WORKFLOW SKILL — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases.
- Works in 7 steps: Identify the operation (issue, PR,… → Use gh CLI by default — always available… → Fall back to MCP only when gh cannot… → …
- : Azure infrastructure
- SKILL.md covers Steps, Rules, Branch Naming Quick Reference and Conventional Commits Quick…, plus 4 more sections
- Calls gh and git
What it does
Apex GitHub Operations is an agent skill from jonathan-vella/apex. 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).
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/branch-strategy.md`, `references/commit-conventions.md` and `references/detailed-commands.md`).
It sits in DevOps & Cloud, covering Infrastructure as code, Commit messages and Git workflow. It works with GitHub, Model Context Protocol, Bicep and Terraform. The repository describes itself as: APEX turns Azure platform engineering requirements into verified, deploy-ready IaC — powered by GitHub Copilot agents, real-time pricing, and built-in compliance. The licence is MIT.
When your agent uses it
- : Azure infrastructure
- Bicep/Terraform code
- Architecture decisions
Example prompts
- “commit”
- “open PR”
- “create branch”
- “/apex-github-operations”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Identify the operation (issue, PR, search, Actions, release, etc.)
- Use gh CLI by default — always available in this dev container; the more stable primitive
- Fall back to MCP only when gh cannot satisfy the operation (rich PR review threads, bulk GraphQL, Copilot review requests)
- Validate branch name before any commit or PR — git rev-parse --abbrev-ref HEAD; if invalid, stop and rename via git branch -m
- Conventional Commits are mandatory — enforced by commitlint
- Devcontainer: do not run gh auth unless explicitly asked to troubleshoot authentication.
- Never skip hooks (--no-verify) unless the user explicitly asks
What it can do on your machine
Read from SKILL.md and the folder at commit c209d8b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
ghgit
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Apex GitHub Operations loads about 1.5k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 475 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from jonathan-vella/apex at commit c209d8b, republished under its MIT licence (© jonathan-vella). 475 words, ~1,480 tokens.
Download SKILL.mdSave it as
.claude/skills/apex-github-operations/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- apex-github-operations
- description
- **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).
- user-invocable
- true
- disable-model-invocation
- false
- argument-hint
- GitHub operation and repository or branch scope
- license
- MIT
- metadata.author
- apex
- metadata.version
- 3.0
- metadata.category
- github
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
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 + MergeRules
- Identify the operation (issue, PR, search, Actions, release, etc.)
- Use
ghCLI by default — always available in this dev container; the more stable primitive - Fall back to MCP only when
ghcannot satisfy the operation (rich PR review threads, bulk GraphQL, Copilot review requests) - Validate branch name before any commit or PR —
git rev-parse --abbrev-ref HEAD; if invalid, stop and rename viagit branch -m - Conventional Commits are mandatory — enforced by commitlint
- Devcontainer: do not run
gh authunless explicitly asked to troubleshoot authentication. Use configured CLI credentials; never request tokens through chat or switch identity implicitly. - 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.
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.
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:
squashunless the user specifies otherwise.
For tool tables, creation pre-flight checks, and the gh-vs-MCP decision
lattice, read references/issues-and-prs.md.
For PR lifecycle states, auto-labels, and auto-merge conditions, read
references/smart-pr-flow.md.
Show full SKILL.md (175 more words)Show less
CLI Commands
For complete gh CLI commands covering repos, Actions, releases, secrets,
API, and auth, read
references/detailed-commands.md.
IMPORTANT:
gh api -fdoes not support object values. Use multiple-fflags 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.
Reference Index
Operational procedures: commit/push/PR and sensei-free PR. The manual Host entrypoint is apex-host-git-commit; it requires explicit owner/model selection and does not change the Local slash name.
| 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 |
© jonathan-vella, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (references) in .github/skills/apex-github-operations of jonathan-vella/apex.
- SKILL.md
- references/branch-strategy.md
- references/commit-conventions.md
- references/detailed-commands.md
- references/git-commit.md
- references/issues-and-prs.md
- references/merge-sensei-free-pr.md
- references/smart-pr-flow.md
Open the folder on GitHubat commit c209d8b
Compare with similar skills
Apex GitHub Operations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Apex GitHub Operations this skilljonathan-vella/apex | 217 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Azv Bicep Diagram SyncAzure/AZVerify | 101 | — | ~2.9k | Automated safety check: Pass | MIT | |
| Azure Well Architected Reviewgithub/awesome-copilot | 40k | — | ~2.5k | Automated safety check: Pass | MIT | |
| Azure Pricing Lookupthomast1906/github-copilot-agent-skills | 202 | — | ~4.9k | Automated safety check: Pass | None | |
| Terravision Cloud Diagramspatrickchugh/terravision | 1.6k | — | ~5.6k | Automated safety check: Notes | AGPL-3.0-only | |
| Azure CopilotMicrosoftDocs/Agent-Skills | 775 | — | ~1.4k | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
- Official
- Official
Azure Well Architected Review
github/awesome-copilot
Perform an Azure Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.
Azure Pricing Lookup
thomast1906/github-copilot-agent-skills
Looks up live Azure retail prices by SKU, service or region through the Azure MCP pricing tool, estimates template costs and compares regions, price types and savings plans.
Terravision Cloud Diagrams
patrickchugh/terravision
Draw cloud architecture diagrams for AWS, Azure or GCP with the official provider icon sets, using TerraVision.
- Official
Azure Copilot
MicrosoftDocs/Agent-Skills
Expert knowledge for Azure Copilot development including troubleshooting, decision making, architecture & design patterns, security, configuration, and integrations & coding patterns.
Azure Diagrams
cmb211087/azure-diagrams-skill
Comprehensive technical diagramming toolkit for solutions architects, presales, and developers.
More from jonathan-vella/apex
All 39 skills in this repoApex Azure Diagnostics
jonathan-vella/apex
WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.
Apex Azure Governance Discovery
jonathan-vella/apex
ANALYSIS SKILL — Azure Policy discovery: effective assignments (incl.
Apex Context Management
jonathan-vella/apex
UTILITY SKILL — Two-mode context-window management. An agent skill from jonathan-vella/apex.
Apex Python Diagrams
jonathan-vella/apex
UTILITY SKILL — Python diagram generation for Azure architectures, WAF/cost/compliance charts, ERDs, swimlanes, timelines, and wireframes.
Apex Terraform Search Import
jonathan-vella/apex
WORKFLOW SKILL — Manual-only discovery and import of existing Azure resources into Terraform management.
Apex Vendor Prompting
jonathan-vella/apex
ANALYSIS SKILL — Manual-only audit of Anthropic Claude Opus 5.5 / Sonnet 5.5 and OpenAI GPT-6 / GPT-5.6 prompting guidance and APEX conventions.
Related
Categories
Questions about Apex GitHub Operations
What does Apex GitHub Operations do?
WORKFLOW SKILL — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases. Apex GitHub Operations is an agent skill from jonathan-vella/apex. WORKFLOW SKILL — Full GitHub contribution lifecycle: branches, conventional commits, issues, PRs, Actions, releases.
When should I use Apex GitHub Operations?
Apex GitHub Operations fits situations like: : Azure infrastructure; bicep/Terraform code; architecture decisions.
How do I install Apex GitHub Operations in Claude Code?
Run `npx skills add jonathan-vella/apex --skill apex-github-operations -a claude-code`. Or copy the skill folder (.github/skills/apex-github-operations in jonathan-vella/apex) into .claude/skills/apex-github-operations in your project. Claude Code loads it when a task matches its description.
How do I install Apex GitHub Operations in Codex?
Run `npx skills add jonathan-vella/apex --skill apex-github-operations -a codex`. Or copy the skill folder (.github/skills/apex-github-operations in jonathan-vella/apex) into .agents/skills/apex-github-operations in your project. Codex loads it when a task matches its description.
Can I use Apex GitHub Operations in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jonathan-vella/apex --skill apex-github-operations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apex-github-operations, .gemini/skills/apex-github-operations, .github/skills/apex-github-operations and .opencode/skills/apex-github-operations in your project.
What does Apex GitHub Operations need to run?
Going by SKILL.md and its folder, Apex GitHub Operations needs the command-line tools its instructions call (gh and git).
Does Apex GitHub Operations access the network?
SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Apex GitHub Operations safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Apex GitHub Operations use?
Apex GitHub Operations is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Apex GitHub Operations use?
About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9k tokens, read only when the agent opens those files.
What are the alternatives to Apex GitHub Operations?
Skills that share tags, products or a category with Apex GitHub Operations: Azv Bicep Diagram Sync (Azure/AZVerify, 101 stars), Azure Well Architected Review (github/awesome-copilot, 40k stars), Azure Pricing Lookup (thomast1906/github-copilot-agent-skills, 202 stars) and Terravision Cloud Diagrams (patrickchugh/terravision, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Apex GitHub Operations?
jonathan-vella (a GitHub user) maintains it in jonathan-vella/apex, which has 217 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 7, 2026.
Source: jonathan-vella/apex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.