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.
How do I install this agent skill?
npx skills add https://github.com/microsoft/azure-skills --skill aks-known-issuesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a structured way to troubleshoot Azure Kubernetes Service (AKS) by matching specific error signatures against a catalog of known fixes. It emphasizes safety through explicit user approval for any changes and directs users to official Microsoft documentation.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
AKS Known Issues
Quick Reference
| Property | Value |
|---|---|
| Best for | Exact signature plus AKS operation |
| Output | Cause, 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
- 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.
Error Handling
| Input | Response |
|---|---|
| Bare wrapper/number | Request nested signature and CSE context |
| Generic AKS | aks-troubleshooting |
| Non-AKS | No AKS skill |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoft/azure-skills/aks-known-issues">View aks-known-issues on skillZs</a>