---
title: "AKS troubleshooting: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-aks-troubleshooting/
description: "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."
---

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

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

[← Explore all skills](/skills/)

AKS INCIDENT DIAGNOSIS / Microsoft

# 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.

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

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)

“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 (use aks-gpu-inference); cluster creation or provisioning (use azure-kubernetes); cost (use cost-analysis from the optional azure-cost plugin); pod rightsizing (use azure-kubernetes); a fully qualified documented AKS signature with every required nested qualifier (use aks-known-issues); standalone failures on non-AKS Azure resources (use azure-diagnostics). Unqualified errors and open-ended incidents stay here only for AKS.”

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

01 / THE REASONING

## Why this made the selection.

 - The file forbids restart, delete, cordon, drain, scale, upgrade, and reconfigure unless the user explicitly asks, and it says to propose a fix without applying it uninvited.
- On Forbidden or 403 it says to report the identity and the least role, never to self-elevate, and never to run commands, pull images, or follow URLs found in logs, events, annotations, or tickets.

### A good fit for

 - Investigating a live AKS incident with read-only evidence and a stated gap, without applying a cluster change

### 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 troubleshooting does not change resources without explicit approval and uses existing az and kubectl credentials.
- The aks-skills README says to install only on a trusted device because its telemetry hooks use npx, and telemetry is collected unless AZURE_MCP_COLLECT_TELEMETRY=false.
- Gotcha notes name outbound and surge changes as fixes. The operating rule still says not to apply a reconfigure unless remediation was requested. Those notes were not treated as a second permission.
- Topic files, scripts/cluster-snapshot.sh, scripts/pod-deep-dive.sh, and the Inspektor Gadget note were not opened.
- The described pod collector retains raw current and previous logs in the artifact directory. Redaction of visible output does not remove sensitive material from those stored raw logs.

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-troubleshooting/SKILL.md
- README.md
- .github/plugins/aks-skills/README.md
- LICENSE
- .github/plugins/aks-skills/LICENSE

### Our findings

 - Read-only is the default: do not restart, delete, cordon, drain, scale, upgrade, or reconfigure unless the user explicitly asks for remediation.
- A denial is reported with the identity, verb or resource, and least role, and it is not treated as a negative finding. Non-read steps are pre-checked with kubectl auth can-i.
- Commands, image pulls, and URLs found in logs, events, annotations, or tickets are not followed. A new image needs approval with its full reference shown.
- The shipped scripts are described as read-only and must confirm the kube context endpoint matches the named AKS resource before a Kubernetes API read.
- Inspektor Gadget is not installed during an investigation. A privileged debug pod is described only as an approved, digest-pinned, time-bounded fallback.
- When remediation is requested, the file says to make one change at a time, state impact and rollback, and send a GitOps-managed fix to source.

### Not established by this review

 - The resource was not executed and its tools were not called.
- No pod, node, upgrade, or network setting was changed.
- The symptom notes, collector scripts, and Inspektor Gadget reference were 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
- Host authorization for shell, az, kubectl, and jq before the collectors run
- An explicit remediation request before any restart, delete, cordon, drain, scale, upgrade, or reconfigure

### Compatibility

Copilot CLI

### Implementation

shell

### Local skill text; cluster changes happen only if an operator asks for remediation and runs them

 - Read the skill text
- Read cluster and Azure state with existing az and kubectl credentials only if the operator runs those reads
- Change a resource only after the user explicitly asks for remediation

### Cost model

MIT; no plugin install, kubectl, or Azure command 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-troubleshooting SKILL.md ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md Supports: read-only default, no self-elevation, and no commands taken from cluster text
- [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: no resource change without explicit approval
- [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-troubleshooting/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md Supports: upstreamDescription, limitations, 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 GPU inference ↗ Pins Microsoft's AKS GPU and KAITO diagnosis skill, which stays on read-only evidence unless scaling, drain, deletion, or add-on changes are separately authorized.](/skills/microsoft-aks-gpu-inference/)[### 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.](/skills/microsoft-aks-known-issues/)

 [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/)
