Azure Kubernetes Automatic Readiness
microsoft/GitHub-Copilot-for-Azure
Assess Kubernetes workloads and cluster configuration for AKS Automatic compatibility.
WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.
$ npx skills add jonathan-vella/apex --skill apex-azure-diagnostics -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jonathan-vella/apex apex-azure-diagnostics --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-azure-diagnostics .claude/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .claude/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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-azure-diagnosticsType 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-azure-diagnostics -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jonathan-vella/apex apex-azure-diagnostics --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-azure-diagnostics .agents/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .agents/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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-azure-diagnostics -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jonathan-vella/apex apex-azure-diagnostics --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-azure-diagnostics .cursor/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .cursor/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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-azure-diagnostics--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-azure-diagnostics -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jonathan-vella/apex apex-azure-diagnostics --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-azure-diagnostics .gemini/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .gemini/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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-azure-diagnosticsInstalls 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-azure-diagnostics -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-azure-diagnostics .github/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .github/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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-azure-diagnostics -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-azure-diagnostics --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-azure-diagnostics .opencode/skills/apex-azure-diagnostics && 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-azure-diagnostics" agent skill from https://github.com/jonathan-vella/apex/tree/main/.github/skills/apex-azure-diagnostics into .opencode/skills/apex-azure-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apex-azure-diagnostics", 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.
apex-azure-diagnosticsWORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.
Apex Azure Diagnostics is an agent skill from jonathan-vella/apex. WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis. WHEN: 'troubleshoot container apps', 'troubleshoot AKS', 'pod crashloop', 'VM RDP or SSH failure', 'app service high CPU', 'service bus errors'. DO NOT USE FOR: pre-deploy validation (apex-azure-validate), cost (apex-azure-cost-optimization), AKS design (apex-azure-kubernetes).
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 62 other files, including scripts and reference files (for example `references/aks/aks-troubleshooting.md`, `references/aks/general-diagnostics.md` and `references/aks/load-balancer-and-ingress.md`).
It sits in DevOps & Cloud, covering Container orchestration. It works with Microsoft Azure, Microsoft Sentinel, Kubernetes and Model Context Protocol. 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.
8 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit b8e5908. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
azFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use az, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Apex Azure Diagnostics loads about 2.1k tokens when it runs, and up to ~36k if it reads all its reference files. Until then it costs about 110 tokens; SKILL.md has 653 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.
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); the scripts in this folder are not scanned.
The full file from jonathan-vella/apex at commit b8e5908, republished under its MIT licence (© jonathan-vella). 653 words, ~2,105 tokens.
.claude/skills/apex-azure-diagnostics/SKILL.md (or your agent's skills folder). This skill also uses 58 other files; get the full folder from GitHub.AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE
This document is the official source for debugging and troubleshooting Azure production issues. Follow these instructions to diagnose and resolve common Azure service problems systematically.
Activate this skill when user wants to:
run-command, credential resets, NSG changes,
cordon/drain and node debug pods (run-ig with --approve) each need explicit approvalFollow the diagnostic workflow for discovery, health/metrics, logs, recent changes, severity classification and reporting. That procedure owns phase order and the severity-to-priority mapping. Load only the health checks and query templates needed for the selected service.
| Service | Common Issues | Reference |
|---|---|---|
| Container Apps | Image pull failures, cold starts, health probes, port mismatches | container-apps/ |
| App Service | High CPU, deployment failures, crashes, slow responses, TLS/custom domains | app-service/ |
| Function Apps | App details, invocation failures, timeouts, binding errors, cold starts, missing app settings | functions/ |
| AKS | Cluster access, nodes, kube-system, scheduling, crash loops, ingress, DNS, upgrades | AKS troubleshooting |
| Compute (VM) | RDP/SSH connectivity, NSG/firewall blocks, credential resets, VM agent issues | VM connectivity |
| Messaging | Event Hubs and Service Bus SDK errors, AMQP failures, message lock, connectivity | Messaging troubleshooting |
Route active AKS incidents, VM connectivity and messaging SDK problems to their guides above; keep Container Apps, App Service and Function Apps diagnostics in this skill.
Bash and PowerShell pairs in scripts/ gather evidence in one pass. All are read-only except run-ig.
| Script | Purpose |
|---|---|
aks-baseline | AKS provisioning state, node pools, recent activity, node readiness and kube-system health |
pod-evidence | Status, describe, current and previous logs, and resource usage for unhealthy pods |
run-ig | Inspektor Gadget trace through a privileged node debug pod; runs only with --approve/-Approve |
appservice-diagnostics | App Service config, recent deployments, app setting names and custom domains |
containerapp-diagnostics | Container App revisions, registry and ingress config, and recent logs |
test-messaging-connectivity | DNS, HTTPS and AMQP/Kafka port reachability for a Service Bus or Event Hubs namespace |
# Inspect resource metadata (not Resource Health availability)
az resource show --ids RESOURCE_ID
# View activity log
az monitor activity-log list -g RG --max-events 20
# Container Apps logs
az containerapp logs show --name APP -g RG --follow
# Function App logs (query App Insights traces)
az monitor app-insights query --apps APP-INSIGHTS -g RG \
--analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"For AI-powered diagnostics, use:
mcp_azure-mcp_applens
intent: "diagnose issues with <resource-name>"
command: "diagnose"
parameters:
resourceId: "<resource-id>"
Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendationsFor querying logs and metrics:
mcp_azure-mcp_monitor
intent: "query logs for <resource-name>"
command: "logs_query"
parameters:
workspaceId: "<workspace-id>"
query: "<KQL-query>"See kql-queries.md for common diagnostic queries.
mcp_azure-mcp_resourcehealth
intent: "check health status of <resource-name>"
command: "get"
parameters:
resourceId: "<resource-id>"Metadata/provisioning state from az resource show is not Resource Health
availability. If the Resource Health tool is unavailable, report that check as
unavailable and continue the approved health checks.
Load these references on demand, not all at once.
© 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
SKILL.md and 58 other files (scripts, references) in .github/skills/apex-azure-diagnostics of jonathan-vella/apex.
Open the folder on GitHubat commit b8e5908
Apex Azure Diagnostics 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 Azure Diagnostics this skilljonathan-vella/apex | 217 | — | ~2.1k | Automated safety check: Pass | MIT | |
| Azure Kubernetes Automatic Readinessmicrosoft/GitHub-Copilot-for-Azure | 255 | 1 repos | ~4.4k | Automated safety check: Pass | MIT | |
| Azure Diagnosticsmicrosoft/GitHub-Copilot-for-Azure | 255 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Install Boltmcpboltmcp/boltmcp | 371 | — | ~2.3k | Automated safety check: Pass | None | |
| K8s Agent Sandbox MCPkubernetes-sigs/agent-sandbox | 4.2k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Provider Bug Reviewmondoohq/mql | 412 | — | ~2.9k | Automated safety check: Pass | Custom licence |
microsoft/GitHub-Copilot-for-Azure
Assess Kubernetes workloads and cluster configuration for AKS Automatic compatibility.
microsoft/GitHub-Copilot-for-Azure
Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage.
boltmcp/boltmcp
A skill your agent uses when asked to help install or uninstall BoltMCP
kubernetes-sigs/agent-sandbox
An MCP server skill for managing Kubernetes sandboxes. An agent skill from kubernetes-sigs/agent-sandbox.
mondoohq/mql
Deep static code review of an mql provider for logic errors, nil-handling bugs, pagination truncation, caching/id collisions, and other defects that silently give users wrong data.
CommunityToolkit/Aspire
ANALYSIS SKILL - Observe Aspire apps: logs, traces, metrics, resource state, telemetry export, browser telemetry, and the standalone dashboard.
jonathan-vella/apex
ANALYSIS SKILL — Azure Policy discovery: effective assignments (incl.
jonathan-vella/apex
UTILITY SKILL — Two-mode context-window management. An agent skill from jonathan-vella/apex.
jonathan-vella/apex
UTILITY SKILL — Python diagram generation for Azure architectures, WAF/cost/compliance charts, ERDs, swimlanes, timelines, and wireframes.
jonathan-vella/apex
WORKFLOW SKILL — Manual-only discovery and import of existing Azure resources into Terraform management.
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.
jonathan-vella/apex
WORKFLOW SKILL — Creates, restructures, and audits GitHub Copilot .agent.md and .prompt.md files with correct frontmatter, handoffs, model policy, context budgets, and validation.
Categories
WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis. Apex Azure Diagnostics is an agent skill from jonathan-vella/apex. WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.
Apex Azure Diagnostics fits situations like: : pre-deploy validation (apex-azure-validate); cost (apex-azure-cost-optimization); AKS design (apex-azure-kubernetes).
Run `npx skills add jonathan-vella/apex --skill apex-azure-diagnostics -a claude-code`. Or copy the skill folder (.github/skills/apex-azure-diagnostics in jonathan-vella/apex) into .claude/skills/apex-azure-diagnostics in your project. Claude Code loads it when a task matches its description.
Run `npx skills add jonathan-vella/apex --skill apex-azure-diagnostics -a codex`. Or copy the skill folder (.github/skills/apex-azure-diagnostics in jonathan-vella/apex) into .agents/skills/apex-azure-diagnostics in your project. Codex loads it when a task matches its description.
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-azure-diagnostics -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-azure-diagnostics, .gemini/skills/apex-azure-diagnostics, .github/skills/apex-azure-diagnostics and .opencode/skills/apex-azure-diagnostics in your project.
Going by SKILL.md and its folder, Apex Azure Diagnostics needs the command-line tools its instructions call (az).
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Apex Azure Diagnostics is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.1k tokens (SKILL.md is roughly 8.4k 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 34k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Apex Azure Diagnostics: Azure Kubernetes Automatic Readiness (microsoft/GitHub-Copilot-for-Azure, 255 stars), Azure Diagnostics (microsoft/GitHub-Copilot-for-Azure, 255 stars), Install Boltmcp (boltmcp/boltmcp, 371 stars) and K8s Agent Sandbox MCP (kubernetes-sigs/agent-sandbox, 4.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
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 10, 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.