SKILL

aks-known-issues

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.

Target: Software development & testing. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • AKS Known Issues
  • Quick Reference
  • When to Use This Skill
  • MCP Tools
  • Workflow
  • Error Handling

| Property | Value | |---|---| | Best for | Exact signature plus AKS operation | | Output | Cause, fix, and Learn citation | Use the catalog. 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. None required. Use advertised read-only Azure tools or CLI queries. 1. Capture exact code, nested message, operation, and AKS resource. 2. Require every qualifier; codes are not substrings. 3. Give cause, fix, citation, and read-only verification. 4. State what ran; require explicit approval before every mutation. | Input | Response | |---|---| | Bare wrapper/number | Request nested signature and CSE context | | Generic AKS | aks-troubleshooting | | Non-AKS | No AKS skill |

Source repository
microsoft/skills
Source file
.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md
Fixed revision
9287b443662d2433c85621c7325ee72a0ce499b5
Read the complete original documentation ↗

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: Microsoft Skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-10T19:02:05.867Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.