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.
“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.”
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.
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.
- 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
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 ↗Checked
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 ↗Checked
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 ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT heading and the azure plugin install line
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
- AKS skills plugin LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE
Supports: MIT License, same redistribution terms as the repository root
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md
Supports: upstreamDescription, bestFor, review