---
title: "AKS known issues: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-aks-known-issues/
description: "Pins Microsoft's AKS known-issue skill, which refuses a match unless every catalog qualifier is present and requires approval before any mutation."
---

# AKS known issues: review, setup & limitations · Undominated.ai

> Pins Microsoft's AKS known-issue skill, which refuses a match unless every catalog qualifier is present and requires approval before any mutation.

[← Explore all skills](/skills/)

AKS INCIDENT MATCHING / Microsoft

# AKS known issues

Pins Microsoft's AKS known-issue skill, which refuses a match unless every catalog qualifier is present and requires approval before any mutation.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 6 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE)
 Revision fc164ba1d7a0
 [Read what was—and wasn’t—checked ↓](#review)

“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.”

 [Microsoft · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The file says not to use the skill unless every qualifier for a catalog row is present, and it says codes are not matched as substrings.
- It limits tools to advertised read-only Azure or CLI queries, asks for read-only verification, and requires explicit approval before every mutation.

### A good fit for

 - Citing a documented AKS cause only when the prompt already contains the full catalog signature and its qualifiers
- Prepare a cause-and-fix handoff with the required Learn citation and a record of which read-only verification ran.

### Weigh up before choosing

 - The resource was not executed.
- No standalone install line for this plugin appears in the fetched files. The aks-skills README embeds `/plugin install aks-skills@azure-skills` in a numbered line, so install.command is null. That plugin install is not this file alone.
- The repository README line `/plugin install azure@skills` installs a different plugin. The aks-skills README says this plugin is not installed automatically.
- The aks-skills README says to install only on a trusted device because its telemetry hooks use npx to download Azure MCP.
- The aks-skills README collects telemetry unless AZURE_MCP_COLLECT_TELEMETRY=false. That switch was not tested.
- references/error-code-map.md was not opened, so the catalog rows themselves were not checked.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - .github/plugins/aks-skills/skills/aks-known-issues/SKILL.md
- README.md
- .github/plugins/aks-skills/README.md
- LICENSE
- .github/plugins/aks-skills/LICENSE

### Our findings

 - The skill is refused when any catalog qualifier is missing, and a bare wrapper or number is sent back for the nested signature.
- Quota errors are out of scope because the file says the catalog has no quota rows and routes those incidents to aks-troubleshooting.
- Generic AKS symptoms go to aks-troubleshooting, and non-AKS failures are not given an AKS skill.
- Listed tools are advertised read-only Azure tools or CLI queries, and verification is described as read-only.
- The workflow says to state what ran and to require explicit approval before every mutation.

### Not established by this review

 - The resource was not executed and its tools were not called.
- No error signature was matched against the catalog and no cluster change was approved.
- references/error-code-map.md was not opened.
- The aks-skills plugin was not installed.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md)
 - The aks-skills README tells Copilot CLI users to add marketplace microsoft/azure-skills and then shows `/plugin install aks-skills@azure-skills` inside a numbered line. That installs the aks-skills plugin, not this file alone, and it is not a line by itself.
- The repository README's own lines are `/plugin marketplace add microsoft/skills` and `/plugin install azure@skills`. Those name the azure plugin, which this plugin README says is separate.
- The repository README also shows `npx skills add microsoft/skills`, which starts a wizard for the whole repository.

### Before you start

 - Copilot CLI if the plugin README's install steps are used
- An exact catalog signature and every qualifier named for that row
- Explicit approval before any mutation; this review did not approve one

### Compatibility

Copilot CLI

### Local skill text; Azure queries or changes happen only if an operator runs them

 - Read the skill text
- Use advertised read-only Azure tools or CLI queries only if the operator runs them
- Mutate a resource only after explicit approval

### Cost model

MIT; no plugin install or Azure query was run

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [aks-known-issues SKILL.md ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md Supports: full-qualifier refusal, read-only checks, and approval before mutation
- [AKS skills plugin README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md Supports: separate plugin install, npx warning, and telemetry opt-out
- [Repository README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: MIT heading and the azure plugin install line
- [Repository LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: MIT License
- [AKS skills plugin LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE Supports: MIT License, same redistribution terms as the repository root
- [Pinned definition rechecked for the 2026-10-15 resource wave ↗](https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md Supports: upstreamDescription, bestFor, review

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### AKS Automatic Readiness ↗ Pins Microsoft's AKS Automatic readiness skill, which assesses a cluster or local manifests without changing the cluster and writes files only after an accepted diff.](/skills/microsoft-azure-kubernetes-automatic-readiness/)[### AKS troubleshooting ↗ Pins Microsoft's live AKS troubleshooting skill, which does not restart, delete, cordon, drain, scale, upgrade, or reconfigure a resource unless remediation is explicitly requested.](/skills/microsoft-aks-troubleshooting/)[### AI Runway AKS setup ↗ Pins Microsoft's AI Runway AKS setup skill, which requires confirmation before install, deployment, or GPU provisioning.](/skills/microsoft-airunway-aks-setup/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
