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_K8SAPISer...
About
# AKS Known Issues
## Quick Reference
| Property | Value | |---|---| | Best for | Exact signature plus AKS operation | | Output | Cause, fix, and Learn citation |
Use the [catalog](references/error-code-map.md).
## 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
| Input | Response | |---|---| | Bare wrapper/number | Request nested signature and CSE context | | Generic AKS | `aks-troubleshooting` | | Non-AKS | No AKS skill |
Install
Run this command
git clone https://github.com/microsoft/azure-skills && cp -r azure-skills/.github/plugins/aks-skills/skills/aks-known-issues ~/.claude/skills/Works with
Manual steps
Clone the repository and copy the `.github/plugins/aks-skills/skills/aks-known-issues` folder into your Claude skills directory. Compatible with Claude Code, Cursor, Codex, and any Agent Skills-compatible agent.
Frequently asked questions
What is the Aks Known Issues skill?
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_Outbound…
How do I install Aks Known Issues?
Run this in your terminal:
git clone https://github.com/microsoft/azure-skills && cp -r azure-skills/.github/plugins/aks-skills/skills/aks-known-issues ~/.claude/skills/Which AI tools does Aks Known Issues work with?
It works with claude_app, claude_code, claude_api, cursor, codex, windsurf, cline, zed.
Who made Aks Known Issues?
Microsoft, released under the MIT license.
Is Aks Known Issues free?
Yes, it is free to use under the MIT license.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
Audit before you install
Run any source through our checks - AI visibility, security, performance, and stack detection.
AI Agent / MCP Server Tester
ai testing
Automated Web Security Scan
security
AI Content Quality Test
arabic content
Site Stack Detector
migration
PageSpeed Analyzer
performance
AI SEO / AEO / GEO Audit
ai visibility
llms.txt Generator
ai visibility
Schema / JSON-LD Builder
ai visibility
Readability Score
arabic content
AI Cost Calculator
ai testing
Headline Analyzer
arabic content