← Explore all 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.

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

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.

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 ↗
  1. 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.
  2. 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.
  3. 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

04 / FOLLOW THE EVIDENCE

The source trail.

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

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

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md

    Supports: no resource change without explicit approval

  3. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: MIT heading and the azure plugin install line

  4. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: MIT License

  5. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE

    Supports: MIT License, same redistribution terms as the repository root

  6. https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md

    Supports: upstreamDescription, limitations, review

Evidence & Ask