About aks-known-issues
aks-known-issues is a skill for matching exact AKS error signatures to cataloged issues. It requires all qualifiers for a match and returns the cause, fix, Learn citation, and read-only verification guidance.
Key features
- 01Exact signature matching
- 02Qualifier checks for catalog entries
- 03Cause and fix guidance
- 04Microsoft Learn citations
- 05Read-only verification steps
Use cases
- 01Classifying a known AKS operation error
- 02Checking whether a full error signature matches a catalog entry
MCP support
No MCP tools are required. The skill can use advertised read-only Azure tools or CLI queries.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill aks-known-issuesAfter installing, type/aks-known-issuesin Claude Code to confirm it loaded.
Bundled filesreferences/error-code-map.md
Details
From the project READMEAKS Known Issues
Quick Reference
| Property | Value |
|---|---|
| Best for | Exact signature plus AKS operation |
| Output | Cause, fix, and Learn citation |
Use the catalog.
When to Use This Skill
Named catalog signatures only. Generic AKS → aks-troubleshooting; non-AKS →
no AKS skill.
If every qualifier for a catalog row is not present, do not use this skill.
This catalog has no quota-error rows; route AKS quota incidents to
aks-troubleshooting.
MCP Tools
None required. Use advertised read-only Azure tools or CLI queries.
Workflow
- Capture exact code, nested message, operation, and AKS resource.
- Require every qualifier; codes are not substrings.
- Give cause, fix, citation, and read-only verification.
- State what ran; require explicit approval before every mutation.
Error Handling
| Input | Response |
|---|---|
| Bare wrapper/number | Request nested signature and CSE context |
| Generic AKS | aks-troubleshooting |
| Non-AKS | No AKS skill |