
Aks known issues
Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk;
- Scripts
- None
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 3.2K
- Last commit
- today
- License
- MIT
- Listing updated
- today
When your agent uses it
Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-capacity message. Never use for quota errors, code-only or bare wrappers, generic symptoms, incomplete signatures, or failures outside AKS; use aks-troubleshooting or azure-diagnostics.
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 2 files (9 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-known-issues 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-known-issues &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-known-issues" ~/.claude/skills/aks-known-issues &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/aks-known-issues inside it instead.
Copy the skill folder to ~/.agents/skills/aks-known-issues 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-known-issues &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-known-issues" ~/.agents/skills/aks-known-issues &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/aks-known-issues inside it instead.
Copy the skill folder to ~/.cursor/skills/aks-known-issues 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-known-issues &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-known-issues" ~/.cursor/skills/aks-known-issues &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/aks-known-issues 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-known-issuesOr copy the folder to ~/.gemini/skills/aks-known-issues yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/aks-known-issues:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/aks-known-issues &&
cp -R "$tmp/.github/plugins/aks-skills/skills/aks-known-issues" ~/.copilot/skills/aks-known-issues &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/aks-known-issues inside it instead.
Get the folder:
git clone --depth 1 https://github.com/microsoft/skills.gitThen copy skills/.github/plugins/aks-skills/skills/aks-known-issues into your agent's skills folder as aks-known-issues. Agents that support SKILL.md read one folder per skill.
Aks known issues FAQ
How do I install Aks known issues in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/aks-known-issues to use it in all your projects, or to .claude/skills/aks-known-issues in one project.
Does Aks known issues run scripts?
No. It is instructions only, with no 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 known issues?
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

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

Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation
- 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
