AutoGineer
Generated banner for Aks Known Issues
Generated logo for Aks Known Issues

Aks Known Issues

MicrosoftOfficialCreated by Microsoft

  • Skill
  • Tool integration
  • Cloud and DevOps
  • MIT
  • No issues found
Download ZIP

From the author

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.
— the description by Microsoft

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured lookup for known Azure Kubernetes Service (AKS) issues. It is designed to be used only when a user provides an exact, cataloged error signature and the required operational context. By matching specific error codes against a curated catalog, the skill delivers the root cause, a Microsoft Learn citation, and a proposed remediation path. It emphasizes safety by requiring read-only verification before any proposed fix and mandates explicit user approval for any potential system mutation.

What it does

  • Matches exact AKS error signatures against a documented catalog.
  • Provides the root cause and official Microsoft Learn documentation for identified issues.
  • Performs read-only verification of the error state.
  • Proposes specific remediation steps for the identified issue.
  • Requires explicit user approval before any system mutation is performed.

When to use it

  • When you have an exact, full error signature from an AKS operation.
  • When you need to identify the cause of specific provisioning or allocation failures.
  • When you require a documented, official fix for a known AKS error code.
  • When you have confirmed the error is specific to AKS and not a generic or quota-related issue.

Advantages

  • Reduces ambiguity by requiring exact error signatures and qualifiers.
  • Ensures safety by mandating read-only verification and explicit user approval.
  • Provides direct links to official Microsoft troubleshooting documentation.
  • Prevents misdiagnosis by explicitly excluding generic or quota-related errors.

Usage examples

“My AKS node pool failed with VMCannotFitEphemeralOSDisk.”
The agent identifies the ephemeral OS disk size mismatch, provides the relevant Microsoft Learn link, verifies the current configuration, and proposes a fix involving a different SKU or disk type.
“I am seeing VMExtensionError_OutboundConnFail during node provisioning.”
The agent confirms the CSE outbound connection failure, suggests checking firewall/proxy/NSG rules, and provides the link to the official troubleshooting guide.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/microsoft/aks-known-issues/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip aks-known-issues.zip -d .agents/skills

Documentation by Microsoft

AKS Known Issues

Quick Reference

PropertyValue
Best forExact signature plus AKS operation
OutputCause, fix, and Learn citation

Use the catalog.

When to Use This Skill

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

  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.

Error Handling

InputResponse
Bare wrapper/numberRequest nested signature and CSE context
Generic AKSaks-troubleshooting
Non-AKSNo AKS skill

Files

LICENSE

MIT License

Copyright 2025 (c) Microsoft Corporation.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE

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.

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-known-issues · 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 or Microsoft.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download aks-known-issues.zip