CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-kubernetes

Plan, create, and configure production-ready Azure Kubernetes Service (AKS) clusters. Covers Day-0 checklist, SKU selection (Automatic vs Standard), networking options (private API server, Azure CNI Overlay, egress configuration), security, and operations (autoscaling, upgrade strategy, cost analysis). WHEN: create AKS environment, provision AKS, enable AKS observability, design AKS networking, choose AKS SKU, secure AKS, optimize AKS, AKS spot nodes, AKS cluster-autoscaler, rightsize AKS pod, pod rightsizing, over-provisioned AKS pod, pod resource requests and limits, Vertical Pod Autoscaler, VPA recommendations.

Quality

91%

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

78%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.

A strong, well-structured planning skill: concrete recommendations with specific flags and commands, a clearly sequenced 9-step workflow with an error-remediation table, and exemplary progressive disclosure via a keyword-triggered reference table whose targets all exist. The main gaps are minor redundancy with the frontmatter triggers, no consolidated copy-paste example command, and no explicit post-create verification step.

Suggestions

Add a single consolidated example 'az aks create' command (or point to a specific section of cli-reference.md) that assembles the recommended Day-0 parameters (CNI Overlay, --zones 1 2 3, Standard tier, OIDC/workload identity) so the common case is copy-paste ready.

Remove the duplicated 'topology spread constraints' bullet (appears in both section 7 Node Pools and section 8 Reliability) and trim the 'When to Use This Skill' list, which restates the description's WHEN triggers.

Add an explicit post-provision validation checkpoint to the workflow (e.g., 'az aks show' to confirm the applied configuration before declaring the cluster ready).

DimensionReasoningScore

Conciseness

The body is dense and decision-oriented (e.g., 'Avoid B-series VMs — burstable SKUs cause performance/reliability issues', 'Deploy across 3 Availability Zones (--zones 1 2 3)') with almost no explanation of concepts Claude already knows. It falls short of a 5 because the 'When to Use This Skill' section largely duplicates the description's WHEN triggers and 'topology spread constraints' is repeated in both section 7 and section 8.

4 / 5

Actionability

Concrete flags and commands appear throughout ('--node-osdisk-type Ephemeral', 'az aks stop/start', '--enable-oidc-issuer --enable-workload-identity', 'Enable --enable-oidc-issuer --enable-workload-identity' in the error table), and the MCP Tools table names the exact tool to discover. It is not a 5 because there is no single copy-paste-ready 'az aks create' example consolidating the recommended Day-0 parameters — commands are scattered as fragments and deferred to cli-reference.md.

4 / 5

Workflow Clarity

The 9-step Workflow (Cluster Type → Networking → Security → ... → Cost) plus Rules (gather requirements → discover MCP tool → pick SKU → document Day-0 rationale) gives a clear ordered sequence, and the Error Handling table provides remediation loops for common failures. It stays at 4 rather than 5 because there is no explicit post-create validation checkpoint (e.g., 'az aks show' to confirm configuration), and checkpoints like documenting decisions are stated once rather than at each step.

4 / 5

Progressive Disclosure

The body is a well-organized overview with one-level-deep, clearly signaled references: a scenario table mapping trigger keywords ('over-provisioned pods', 'Spot VMs', 'VPA recommendations') to the four deep-dive files, a conditional-load note for optional-aks-operations.md, and a pointer to cli-reference.md — all six referenced files exist in references/. The disambiguation note ('prefer the most specific match... ask the user to clarify') makes navigation unambiguous, matching the 5 anchor rather than the 4 anchor's 'minor organization gaps'.

5 / 5

Total

17

/

20

Passed

Description

100%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.

An exemplary description: concrete multi-action capability statement, an explicit WHEN clause with comprehensive natural trigger terms including synonyms and abbreviations, and a tightly scoped AKS provisioning niche that avoids overlap with sibling skills. Voice is appropriately third-person/imperative with no fluff or over-claims.

DimensionReasoningScore

Specificity

It lists multiple concrete actions ('Plan, create, and configure production-ready... AKS clusters') with comprehensive, specific coverage of sub-capabilities ('Day-0 checklist, SKU selection (Automatic vs Standard), networking options (private API server, Azure CNI Overlay, egress configuration), security, and operations (autoscaling, upgrade strategy, cost analysis)'). This matches the 5 anchor ('multiple specific concrete actions; comprehensive coverage'); it exceeds the 4 anchor, which allows minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both 'what' (plan, create, and configure production-ready AKS clusters, with the coverage enumeration) and 'when' (an explicit 'WHEN:' clause with concrete trigger phrases). This mirrors the 5 anchor's exemplar structure exactly; the 4 anchor's caveat ('when could be more explicit or specific') does not apply given the enumerated trigger list.

5 / 5

Trigger Term Quality

The WHEN clause covers natural user phrasings comprehensively, including synonyms and both abbreviation and full name ('rightsize AKS pod', 'pod rightsizing', 'over-provisioned AKS pod', 'Vertical Pod Autoscaler, VPA recommendations', 'AKS cluster-autoscaler', 'AKS spot nodes'). This matches the 5 anchor's 'comprehensive coverage of natural terms including synonyms' rather than the 4 anchor, which expects a few natural terms missing.

5 / 5

Distinctiveness Conflict Risk

Every capability and trigger is AKS-specific (cluster provisioning, SKU choice, AKS networking, AKS spot nodes, VPA), giving a clear niche with minimal conflict risk, matching the 5 anchor. It is not a 4: the description contains no generic cluster/Kubernetes phrasing that would overlap sibling skills — app deployment and diagnostics are conspicuously absent from both the what and the when.

5 / 5

Total

20

/

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/azure-skills

Path

.github/plugins/azure-skills/skills/azure-kubernetes/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.