Official agent skill

Aks Known Issues

by microsoft in microsoft/GitHub-Copilot-for-Azure

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not…

OfficialMITAuto-check passed

Install Aks Known Issues

skills CLI
$ npx skills add microsoft/GitHub-Copilot-for-Azure --skill aks-known-issues -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/GitHub-Copilot-for-Azure aks-known-issues --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/GitHub-Copilot-for-Azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/aks-skills/skills/aks-known-issues .claude/skills/aks-known-issues && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aks-known-issues
GitHub stars
255
Token cost
~485 tokens
SKILL.md length
134 words
Files
3 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not…

  • Works in 4 steps: Capture exact code, nested message,… → Require every qualifier; codes are not… → Give cause, fix, citation, and read-only… → …
  • Generic symptoms
  • SKILL.md covers Quick Reference, When to Use This Skill, MCP Tools and Workflow, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Aks Known Issues is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. 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 VMExtensionErrorOutboundConnFail, VMExtensionErrorK8SAPIServerConnFail, or VMExtensionErrorK8SAPIServerDNSLookupFail; or…

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/error-code-map.md` and `version.json`).

It works with Microsoft Azure. The repository describes itself as: GitHub Copilot for Azure. The licence is MIT.

When your agent uses it

  • Generic symptoms
  • Incomplete signatures
  • Failures outside AKS
  • Use aks-troubleshooting

Example prompts

  • “NodeImageVersion is not accepted”
  • “/aks-known-issues”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Capture exact code, nested message, operation, and AKS resource.
  2. Require every qualifier; codes are not substrings.
  3. Give cause, fix, citation, and read-only verification.
  4. State what ran; require explicit approval before every mutation.

What it can do on your machine

Read from SKILL.md and the folder at commit ce94fce. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aks Known Issues loads about 485 tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 200 tokens; SKILL.md has 134 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~200
When it runs · the whole SKILL.md, loaded when a task matches
~485
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/GitHub-Copilot-for-Azure at commit ce94fce, republished under its MIT licence (© microsoft). 134 words, ~485 tokens.

Download SKILL.mdSave it as .claude/skills/aks-known-issues/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
aks-known-issues
description
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.
license
MIT
metadata.author
Microsoft
metadata.version
0.0.0-placeholder

AKS Known Issues

Quick Reference

PropertyValue
Best forExact signature plus AKS operation
OutputCause, 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

  1. Capture exact code, nested message, operation, and AKS resource.
  2. Require every qualifier; codes are not substrings.
  3. Give cause, fix, citation, and read-only verification.
  4. State what ran; require explicit approval before every mutation.

Error Handling

InputResponse
Bare wrapper/numberRequest nested signature and CSE context
Generic AKSaks-troubleshooting
Non-AKSNo AKS skill

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/aks-skills/skills/aks-known-issues of microsoft/GitHub-Copilot-for-Azure.

  • SKILL.md
  • references/error-code-map.md
  • version.json

Open the folder on GitHubat commit ce94fce

Compare with similar skills

Aks Known Issues next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aks Known Issues compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aks Known Issues this skillmicrosoft/GitHub-Copilot-for-Azure255—~485Automated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Microsoft Skill CreatorMicrosoftDocs/mcp1.9k3 repos~2.1kAutomated safety check: PassCC-BY-4.0
Microsoft Code ReferenceMicrosoftDocs/mcp1.9k3 repos~1.1kAutomated safety check: PassCC-BY-4.0
Cloud Cost Optimizationwshobson/agents40k14 repos~1.7kAutomated safety check: PassMIT
Add Model Pricelangfuse/langfuse36k—~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Microsoft Skill Creator

    MicrosoftDocs/mcp

    Official

    Create agent skills for Microsoft technologies using official documentation.

    1.9k GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Microsoft Code Reference

    MicrosoftDocs/mcp

    Official

    Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs.

    1.9k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Cuts cloud spend across AWS, Azure, GCP and OCI with cost tagging, rightsizing, commitment and spot pricing models, and architecture changes.

    40k GitHub starsUsed in 14 repos~1.7k tokens
    DevOps & CloudAuto-check passed
  • Add Model Price

    langfuse/langfuse

    A skill your agent uses when editing worker/src/constants/default-model-prices.json, packages/shared/src/server/llm/types.ts, pricing tiers, tokenizer IDs, or matchPattern regexes for OpenAI…

    36k GitHub stars~1.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Datachain Knowledge

    datachain-ai/datachain

    A skill your agent uses whenever datasets, cloud storage buckets, or data pipelines are mentioned — creating, saving, querying, listing, exploring, deleting, or processing data in S3, GCS, Azure…

    2.8k GitHub stars~3k tokensUpdated today
    Knowledge ManagementAuto-check passed

More from microsoft/GitHub-Copilot-for-Azure

All 61 skills in this repo
  • Capacity

    microsoft/GitHub-Copilot-for-Azure

    Official

    Discovers available Azure OpenAI model capacity across regions and projects.

    255 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Deploy Model

    microsoft/GitHub-Copilot-for-Azure

    Official

    Unified Azure OpenAI model deployment skill with intelligent intent-based routing.

    255 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Microsoft Foundry

    microsoft/GitHub-Copilot-for-Azure

    Official

    Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end.

    255 GitHub starsUsed in 1 repo~6.7k tokens
    Auto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • Azure Kubernetes Automatic Readiness

    microsoft/GitHub-Copilot-for-Azure

    Official

    Assess Kubernetes workloads and cluster configuration for AKS Automatic compatibility.

    255 GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed

Works with

Questions about Aks Known Issues

What does Aks Known Issues do?

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not…. Aks Known Issues is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization.

When should I use Aks Known Issues?

Aks Known Issues fits situations like: generic symptoms; incomplete signatures; failures outside AKS; use aks-troubleshooting.

How do I install Aks Known Issues in Claude Code?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill aks-known-issues -a claude-code`. Or copy the skill folder (plugins/aks-skills/skills/aks-known-issues in microsoft/GitHub-Copilot-for-Azure) into .claude/skills/aks-known-issues in your project. Claude Code loads it when a task matches its description.

How do I install Aks Known Issues in Codex?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill aks-known-issues -a codex`. Or copy the skill folder (plugins/aks-skills/skills/aks-known-issues in microsoft/GitHub-Copilot-for-Azure) into .agents/skills/aks-known-issues in your project. Codex loads it when a task matches its description.

Can I use Aks Known Issues in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill aks-known-issues -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aks-known-issues, .gemini/skills/aks-known-issues, .github/skills/aks-known-issues and .opencode/skills/aks-known-issues in your project.

What does Aks Known Issues need to run?

SKILL.md names no scripts, command-line tools or credentials: Aks Known Issues is instructions for the agent only.

Does Aks Known Issues access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aks Known Issues safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aks Known Issues use?

Aks Known Issues is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aks Known Issues use?

About 485 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Aks Known Issues?

Skills that share tags, products or a category with Aks Known Issues: Skill Creator (Azure/azqr, 795 stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Microsoft Code Reference (MicrosoftDocs/mcp, 1.9k stars) and Cloud Cost Optimization (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aks Known Issues?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/GitHub-Copilot-for-Azure, which has 255 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 9, 2026.

Source: microsoft/GitHub-Copilot-for-Azure on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.