
Aks troubleshooting
Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation
- Scripts
- shell
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 3.2K
- Last commit
- today
- License
- MIT
- Listing updated
- today
When your agent uses it
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.
From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.
What it can access
- Runs shell scripts(see the files on GitHub)
- No network calls found in its scripts(see the files on GitHub)
- License: MIT(see the files on GitHub)
From a static check of its 20 files (128 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
Copy the skill folder to ~/.claude/skills/aks-troubleshooting to use it in all your projects:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/aks-troubleshooting &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-troubleshooting" ~/.claude/skills/aks-troubleshooting &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/aks-troubleshooting inside it instead.
Copy the skill folder to ~/.agents/skills/aks-troubleshooting to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/aks-troubleshooting &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-troubleshooting" ~/.agents/skills/aks-troubleshooting &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/aks-troubleshooting inside it instead.
Copy the skill folder to ~/.cursor/skills/aks-troubleshooting to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/aks-troubleshooting &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-troubleshooting" ~/.cursor/skills/aks-troubleshooting &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/aks-troubleshooting inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/microsoft/skills.git --path .github/plugins/aks-skills/skills/aks-troubleshootingOr copy the folder to ~/.gemini/skills/aks-troubleshooting yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/aks-troubleshooting:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/aks-troubleshooting &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-troubleshooting" ~/.copilot/skills/aks-troubleshooting &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/aks-troubleshooting inside it instead.
Get the folder:
git clone --depth 1 https://github.com/microsoft/skills.gitThen copy skills/.github/plugins/aks-skills/skills/aks-troubleshooting into your agent's skills folder as aks-troubleshooting. Agents that support SKILL.md read one folder per skill.
Aks troubleshooting FAQ
How do I install Aks troubleshooting in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/aks-troubleshooting to use it in all your projects, or to .claude/skills/aks-troubleshooting in one project.
Does Aks troubleshooting run scripts?
Yes. It runs shell scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Aks troubleshooting?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
More from microsoft/skills


Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence
- Open source
- 3.2K GitHub stars

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk;
- Open source
- 3.2K GitHub stars

Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence
- Open source
- 3.2K GitHub stars

Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft
- Open source
- 3.2K GitHub stars
- Cloud and infrastructure
