Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-c
Use aks-known-issues to check the exact AKS error and operation I provide against its documented catalog. Require all signature qualifiers; if it matches, explain the cause and documented fix, cite Microsoft Learn, and give read-only verification steps without changing resources.
Required inputs
Full error code and nested message for a documented catalog signature, including every qualifier.
The failed AKS operation and affected AKS resource.
For AKS SkuNotAvailable, include size, location, and zone; a bare wrapper or generic symptom is insufficient.
Previously published starter task based on a pinned source version; check the source and required inputs before running. Task evidence ↗
SKILL.md
name: aks-known-issueslicense: MITmetadata: author: Microsoft version: "1.2.1"description: "Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-capacity message. Never use for quota errors, code-only or bare wrappers, generic symptoms, incomplete signatures, or failures outside AKS; use aks-troubleshooting or azure-diagnostics."
Named catalog signatures only. Generic AKS → aks-troubleshooting; non-AKS →
no AKS skill.
If every qualifier for a catalog row is not present, do not use this skill.
This catalog has no quota-error rows; route AKS quota incidents to
aks-troubleshooting.
MCP Tools
None required. Use advertised read-only Azure tools or CLI queries.
Workflow
Capture exact code, nested message, operation, and AKS resource.
Require every qualifier; codes are not substrings.
Give cause, fix, citation, and read-only verification.
State what ran; require explicit approval before every mutation.