CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aks-known-issues

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.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary lean skill body: terse sections, explicit qualifier and mutation-approval checkpoints, concrete error-routing, and a clean single-level handoff to the catalog reference. The only improvement space is inlining one or two concrete verification commands in the body rather than deferring all mechanics to the catalog.

DimensionReasoningScore

Conciseness

The body is ~38 lines of lean tables and terse directives with zero padding and no explanation of concepts Claude already knows (e.g., "None required. Use advertised read-only Azure tools or CLI queries."). Every section earns its place.

5 / 5

Actionability

The workflow gives concrete, executable directives ("Capture exact code, nested message, operation, and AKS resource", "Require every qualifier; codes are not substrings", "require explicit approval before every mutation") and the Error Handling table maps inputs to concrete responses. It falls short of anchor 5 only because the per-error verification mechanics (e.g., `az vm list-skus`, `az aks check-acr`) live entirely in the catalog reference rather than the body, leaving minor gaps in copy-paste-ready specifics.

4 / 5

Workflow Clarity

The four-step workflow is a clear sequence with explicit validation checkpoints: the qualifier gate in step 2 ("Require every qualifier"), read-only verification in step 3, and the mutation approval gate in step 4 ("require explicit approval before every mutation"). The Error Handling table supplies recovery routing for non-matching inputs, fulfilling the error-recovery expectation of anchor 5.

5 / 5

Progressive Disclosure

The body is a lean overview and the bulk detail (the signature catalog) is correctly split into a single, clearly signaled, one-level-deep reference — "Use the [catalog](references/error-code-map.md)" — which exists as a real file with no further nesting. Navigation is trivial.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly disciplined description: it defines a narrow, exact-match niche, enumerates concrete signatures and qualifiers, and gives explicit negative triggers and routing to sibling skills. The only gaps are that the deliverables (cause, fix, citation) are unstated and a few catalog signatures lack their literal keywords.

DimensionReasoningScore

Specificity

"Lookup documented AKS fixes" is a concrete action, reinforced by concrete routing behavior ("use aks-troubleshooting or azure-diagnostics") and fully enumerated matching conditions with no vague language. It falls between anchor 3 (1-2 concrete actions) and anchor 5: the action list itself is short, but everything stated is maximally concrete; the minor gap is that the deliverables (cause, fix, Learn citation) are not stated in the description.

4 / 5

Completeness

The 'what' is explicit ("Lookup documented AKS fixes") and the 'when' is explicit with concrete trigger phrases ("only when the prompt includes an exact catalog signature and all of its qualifiers" followed by the enumerated signatures, plus "Never use for quota errors..."). This matches the anchor-5 example structure of clear what + concrete when.

5 / 5

Trigger Term Quality

Trigger terms are the exact strings users paste from AKS error output ("VMCannotFitEphemeralOSDisk", "'NodeImageVersion is not accepted'", "ZonalAllocationFailed with insufficient zone capacity") plus explicit negative triggers ("quota errors, code-only or bare wrappers"). Coverage is good but not comprehensive: several catalog signatures (K8sVersionNotSupported, OperationNotAllowed, LinkedAuthorizationFailed, OrasPullUnauthorized/CSE 212, ACR 401 image pull) are only covered by the abstract phrase "an exact catalog signature" rather than by their actual keywords, so a few natural terms are missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche (documented AKS known-issue lookups keyed on exact catalog signatures) with explicit negative triggers and explicit redirects to sibling skills ("use aks-troubleshooting or azure-diagnostics"), making wrong-skill triggering very unlikely.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

microsoft/GitHub-Copilot-for-Azure

Path

plugins/aks-skills/skills/aks-known-issues/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.