CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aks-gpu-inference

Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence. WHEN: 'Insufficient nvidia.com/gpu', GPU pod Pending, model-load OOM, DCGM/VRAM, KAITO Workspace not ready, or GPU autoscaling. DO NOT USE FOR: setup (airunway-aks-setup), non-GPU incidents (aks-troubleshooting), standalone VM quota (azure-quotas), or generic cost (cost-analysis or cost-optimization from the optional azure-cost plugin).

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is aks-gpu-inference in microsoft/GitHub-Copilot-for-Azure

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured diagnostic skill body: lean routing content, an unambiguous evidence-first workflow, and a clean one-level-deep reference bundle verified against the actual files. The main headroom is in the Host Capability Gate prose (trimmable) and the absence of an explicit re-validation loop for contradictory evidence.

Suggestions

Trim the Host Capability Gate section to a compact authorization checklist — phrases like 'A governed Azure CLI tool alone does not establish these capabilities' and 'The authorization requirements below still apply' restate the same constraint twice and could be merged.

Inline one or two first-step commands in the workflow (e.g., the kubectl describe pod / node jsonpath capture from gpu-scheduling.md) so the body is self-sufficient for initial evidence capture before routing to references.

Add an explicit re-validation checkpoint in the Error Handling table for missing/contradictory evidence — e.g., 'after the owner supplies the read, re-correlate events/status and re-assess confidence before reporting' — to close the feedback-loop gap.

DimensionReasoningScore

Conciseness

The body is lean with no concept explanations Claude already knows — the Quick Reference table, routing workflow, and error-handling table all carry operational content, and concrete specifics like "exporter on port 19400" and "FB_USED/FB_FREE" are kept inline. The Host Capability Gate section has some redundant policy phrasing ("A governed Azure CLI tool alone does not establish these capabilities" / "The authorization requirements below still apply") that could be trimmed, keeping it below the every-token-earns-its-place anchor.

4 / 5

Actionability

As an instruction-only skill, the guidance is concrete: bind specific resources ("subscription, cluster, kube context, pool"), capture exact evidence, separate "container/host OOM from device-allocation failures" with named signals ("OOMKilled", "FB_USED/FB_FREE", port 19400), and route to four verified reference files that contain the executable az/kubectl commands. It stops short of fully copy-paste-ready commands in the body itself — those live one level deeper in the references — which is the minor gap versus the 5 anchor.

4 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with routing to per-domain references, and the Error Handling table supplies explicit checkpoints ("Mark unconfirmed; request the owner/read", "Propose separately and wait for authorization") plus a reporting step that names evidence, confidence, and missing evidence. It lacks an explicit re-validate/fix feedback loop for contradictory evidence — the table says mark unconfirmed and request a read, but no re-check cycle — which keeps it below the 5 anchor.

4 / 5

Progressive Disclosure

SKILL.md is a concise overview that routes to all four existing reference files ([scheduling](references/gpu-scheduling.md), [observability](references/gpu-observability.md), [KAITO](references/kaito-workspaces.md), [scaling](references/gpu-cost-and-scaling.md)) with clearly labeled, one-level-deep links; the references themselves contain only external documentation links, no nested .md chains. Content is appropriately split and navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, tightly-scoped description that answers what, when, and what-not with concrete incident trigger strings and explicit sibling-skill routing. The only gap is that capability coverage is expressed through a single diagnostic verb plus scenario triggers rather than an enumeration of distinct actions.

DimensionReasoningScore

Specificity

"Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence" names the domain and action, and the trigger list enumerates concrete diagnostic scenarios ("'Insufficient nvidia.com/gpu'", "model-load OOM", "DCGM/VRAM", "KAITO Workspace not ready", "GPU autoscaling") plus named evidence types. This sits noticeably above the anchor that only names 1-2 generic actions, but below a 5 because the description centers on a single verb (diagnose) rather than listing multiple distinct actions.

4 / 5

Completeness

Both halves are explicit: the "what" ("Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence") and the "when" ("WHEN: 'Insufficient nvidia.com/gpu', GPU pod Pending, model-load OOM, DCGM/VRAM, KAITO Workspace not ready, or GPU autoscaling") with concrete trigger phrases. The explicit "DO NOT USE FOR" routing is beyond what the anchor requires.

5 / 5

Trigger Term Quality

Triggers like "GPU pod Pending", "model-load OOM", "KAITO Workspace not ready", and the literal error string "Insufficient nvidia.com/gpu" match exactly what an operator would paste during an incident. A few natural synonyms are missing (e.g., "CUDA out of memory", "device plugin", "GPU node not ready"), which keeps it just below the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (AKS GPU/KAITO Day-2 diagnosis) with an explicit exclusion list naming sibling skills ("setup (airunway-aks-setup), non-GPU incidents (aks-troubleshooting), standalone VM quota (azure-quotas), or generic cost"), which minimizes wrong-skill triggering. It is third-person voice with no first/second-person penalty applying.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

microsoft/azure-skills

Path

.github/plugins/aks-skills/skills/aks-gpu-inference/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.