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-c
Install
/plugin marketplace add microsoft/skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add microsoft/skills --skill aks-known-issuesgit clone --depth 1 https://github.com/microsoft/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/.github/plugins/aks-skills/skills/aks-known-issues ~/.claude/skills/aks-known-issuesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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 |
Details
- Skill name
aks-known-issues- Repository
- microsoft/skills
- Path
.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
FAQ
What does the Aks Known Issues skill do?
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
How do I install the Aks Known Issues skill?
Claude Code plugin: /plugin marketplace add microsoft/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Aks Known Issues popular?
It lives in microsoft/skills, which has 3,222 GitHub stars and 372 forks, and is included in 2 curated skill lists.
Related skills
Azure AI Textanalytics Py
3.2kmicrosoft/skills
Azure AI Text Analytics SDK for sentiment analysis, entity recognition, key phrases, language detection, PII, and healthcare NLP. Use for natural language processing on text. Triggers: "text analytics", "sentiment analysis", "entity recognition", "key phrase", "PII detection", "TextAnalyticsClient".
Azure AI Anomalydetector Java
3.2kmicrosoft/skills
Build anomaly detection applications with Azure AI Anomaly Detector SDK for Java. Use when implementing univariate/multivariate anomaly detection, time-series analysis, or AI-powered monitoring.
Azure AI Openai Dotnet
3.2kmicrosoft/skills
Azure OpenAI SDK for .NET. Client library for Azure OpenAI and OpenAI services. Use for chat completions, embeddings, image generation, audio transcription, and assistants. Triggers: "Azure OpenAI", "AzureOpenAIClient", "ChatClient", "chat completions .NET", "GPT-4", "embeddings", "DALL-E", "Whisper", "OpenAI .NET".
Aks Network Capture
3.2kmicrosoft/skills
Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence. WHEN: "capture packets on an AKS node", "take a pcap", "run tcpdump on AKS", "prove where packets drop". Use for explicit packet-capture intent after read-only diagnostics, not general AKS connectivity or ingress troubleshooting.
Skillhub CLI
5.4kiflytek/skillhub
Connect an Agent to a SkillHub registry and use the official SkillHub CLI to search, install, list, or explicitly upgrade SkillHub skills. Use when a user asks to connect SkillHub, install a SkillHub skill, or manage skills previously installed from SkillHub.
Aks Troubleshooting
3.2kmicrosoft/skills
Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation. WHEN: pod crashes or Pending, CrashLoopBackOff, OOMKilled, ImagePullBackOff, node NotReady, DNS or ingress failure, connectivity timeout, network policy, SNAT exhaustion, node-pool scaling blocked by QuotaExceeded or InsufficientVCPUQuota, upgrade stuck, spot or zone disruption, a bare VMExtensionProvisioningError or AllocationFailed wrapper, an uncataloged capacity symptom, or 'investigate my AKS cluster'. DO NOT USE FOR: packet capture (use aks-network-capture); GPU or model-serving issues (us
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.