Aks Gpu Inference
MicrosoftOfficialCreated by Microsoft
- Skill
- Review and audit
- Cloud and DevOps
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured workflow for diagnosing operational issues in Azure Kubernetes Service (AKS) GPU-enabled clusters and KAITO workspaces. It focuses on identifying the root causes of common failures such as pod scheduling delays, VRAM exhaustion, OOM errors, and workspace readiness issues. The skill emphasizes a read-only approach, requiring explicit user authorization before performing any state-changing operations like scaling or node maintenance.
What it does
- Analyzes GPU pod scheduling failures and pending states.
- Correlates container OOM events with device-level VRAM telemetry.
- Validates KAITO workspace readiness and configuration.
- Inspects GPU profiles and autoscaling settings.
- Provides a framework for gathering evidence from DCGM exporters and Kubernetes status.
- Ensures all diagnostic actions comply with host-level security and authorization policies.
When to use it
- When encountering 'Insufficient nvidia.com/gpu' errors.
- When GPU-enabled pods remain in a Pending state.
- When diagnosing model-load OOM or CUDA device-allocation failures.
- When investigating KAITO workspace not-ready incidents.
- When troubleshooting GPU autoscaling or node-pool capacity issues.
Advantages
- Provides a systematic, profile-aware diagnostic path for complex GPU workloads.
- Distinguishes between container-level memory issues and GPU-specific device exhaustion.
- Maintains strict read-only safety by requiring authorization for any mutation.
- Integrates telemetry from DCGM and Kubernetes events for precise incident correlation.
Usage examples
- “My GPU pod is stuck in Pending, help me diagnose.”
- The agent will bind to the cluster, capture pod events and the current gpuProfile, and investigate scheduling constraints or node capacity issues.
- “Why is my model failing with a CUDA OOM error?”
- The agent will correlate the model-load timestamp with DCGM metrics like FB_USED and FB_FREE to determine if the failure was caused by VRAM exhaustion.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/microsoft/aks-gpu-inference/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip aks-gpu-inference.zip -d .agents/skills
Documentation by Microsoft
AKS GPU Inference Day-2
Quick Reference
| Property | Value |
|---|---|
| Best for | AKS GPU/KAITO failures |
| Evidence | Bound target, events/status, gpuProfile, DCGM |
When to Use This Skill
Use for scheduling, VRAM/OOM, KAITO readiness, and workload scaling. Route exclusions as described above.
MCP Tools
Use a fitting host-advertised Azure read or the references' read-only queries.
Host Capability Gate
Before executing any referenced pipeline, verify that the host authorizes
the required shell and kubectl/az commands against the bound target.
File-backed collection also requires approved artifact storage and access to
any bundled files it uses. A governed Azure CLI tool alone does not establish
these capabilities. Equivalent host reads may replace commands only where
their advertised schemas provide the required evidence.
If execution is unavailable or prohibited, say so and analyze supplied or
redacted events, status, logs, and metrics, or give the operator a scoped
collection plan. State which reads did not run and leave conclusions requiring
missing evidence unconfirmed. Never route kubectl through Azure MCP or
bypass host policy. The authorization requirements below still apply.
Workflow
Bind subscription, cluster, kube context, pool, and affected resource.
Capture exact events/status and observed
gpuProfile; state which reads ran.Route to scheduling, observability, KAITO, or scaling.
Separate container/host OOM from device-allocation failures. For
OOMKilled, correlate container memory limits/usage and node conditions. For Managed+Install device-memory evidence, use the exporter on port 19400 and incident-windowFB_USED/FB_FREE; sizing tables do not establish a cause.For KAITO not-ready, warn that Workspace deletion leaves its GPU pools; cleanup is separate and needs explicit authorization.
Report evidence, confidence, missing evidence, and owner handoff.
Require explicit authorization before scaling, cordon/drain, deletion, add-on enablement, or monitoring mutation.
Error Handling
| Condition | Response |
|---|---|
| Missing/contradictory evidence | Mark unconfirmed; request the owner/read |
| Unknown profile | Preserve evidence; do not prescribe stack repair |
| Mutation required | Propose separately and wait for authorization |
Files
- ATTRIBUTION.mdAdded by AutoGineer977 B
- LICENSELicence file added by AutoGineer1.1 KiB
- SKILL.md3.0 KiB
- references/gpu-cost-and-scaling.md1.6 KiB
- references/gpu-observability.md2.7 KiB
- references/gpu-scheduling.md3.2 KiB
- references/kaito-workspaces.md1.8 KiB
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs Node.js
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Microsoft
- Publisher
- Microsoft (Official)
- Source
- microsoft/skills · .github/plugins/aks-skills/skills/aks-gpu-inference · commit 0696600
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from .github/plugins/aks-skills/LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Microsoft.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download aks-gpu-inference.zip