# Aks troubleshooting

> Aks troubleshooting is an open-source agent skill. Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/microsoft/skills/tree/main/.github/plugins/aks-skills/skills/aks-troubleshooting
- **Repository:** https://github.com/microsoft/skills
- **GitHub stars:** 3,214
- **License:** MIT
- **Skill name:** aks-troubleshooting
- **Collection:** https://github.com/microsoft/skills
- **Listing updated:** 2026-11-17

## About

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.

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

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs shell scripts](https://github.com/microsoft/skills/tree/HEAD/.github/plugins/aks-skills/skills/aks-troubleshooting)
- [No network calls found in its scripts](https://github.com/microsoft/skills/tree/HEAD/.github/plugins/aks-skills/skills/aks-troubleshooting)
- [License: MIT](https://github.com/microsoft/skills/tree/HEAD/.github/plugins/aks-skills/skills/aks-troubleshooting)

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/aks-troubleshooting` to use it in all your projects:

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

### Codex

Copy the skill folder to `~/.agents/skills/aks-troubleshooting` to use it in every repository:

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

### Cursor

Copy the skill folder to `~/.cursor/skills/aks-troubleshooting` to use it in every project:

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

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/microsoft/skills.git --path .github/plugins/aks-skills/skills/aks-troubleshooting
```

Or copy the folder to `~/.gemini/skills/aks-troubleshooting` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/aks-troubleshooting`:

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

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/microsoft/skills.git
```

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

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

---
Source: https://ai-powered.com/skills/aks-troubleshooting
