Skip to content
Skill

Aks troubleshooting

Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation

Install
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

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.

Claude Code docs on skills

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.

Codex docs on skills

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.

Cursor docs on skills

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

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

Gemini CLI docs on skills

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.

VS Code docs on skills

Get the folder:

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.

The SKILL.md format

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

  1. Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence

    • Open source
    • 3.2K GitHub stars
  2. 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
  3. Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence

    • Open source
    • 3.2K GitHub stars
  4. 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
  5. Use Azure Advisor

    • Open source
    • 3.2K GitHub stars
    • Cloud and infrastructure