CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-kubernetes-app-deploy

Use when deploying an existing web application or API to an already-running Azure Kubernetes Service cluster. Detects the framework, generates a Dockerfile and Kubernetes manifests, validates against AKS Deployment Safeguards, and deploys with verification. WHEN: deploy app to AKS, deploy to existing AKS cluster, containerize app for Kubernetes, generate K8s manifests for Azure, set up CI/CD for AKS, my AKS deployment is failing safeguard checks, I have a Django/Express/Spring Boot app to run on AKS. DO NOT USE FOR: creating or provisioning an AKS cluster (use azure-kubernetes), assessing migration to AKS Automatic (use azure-kubernetes-automatic-readiness), or deploying to non-AKS targets like Web Apps, Container Apps, or Functions.

Quality

86%

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

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

The body is a lean, well-organized index with excellent token efficiency, and the references/ section is clearly annotated. Its weaknesses are that the core workflow is fully delegated to `phases/quick-deploy.md` (absent from the bundle) leaving no executable steps or validation checkpoints in SKILL.md itself, and several referenced paths (phases/, knowledge-packs/, templates/) are not present in the bundle.

Suggestions

Inline a minimal executable quick-start sequence (e.g., docker build → az acr push → kubectl apply → kubectl rollout status) in the Workflow section so the skill is actionable even before opening phases/quick-deploy.md.

Add explicit validation checkpoints to the body's workflow, such as running the DS001–DS013 safeguards check before apply and verifying rollout status/health endpoints after deploy, rather than delegating all verification to the referenced phase file.

Ensure the referenced bundle paths (phases/quick-deploy.md, knowledge-packs/frameworks/<framework>.md, templates/) actually exist in the bundle, or fold their content into references/ — the primary workflow pointer currently dangles, undermining the otherwise well-organized navigation.

DimensionReasoningScore

Conciseness

"Requires: existing AKS cluster, `az login`, `kubectl` configured" and the bare "DS001–DS013 failures" trigger phrase assume Claude's competence with zero concept explanations; all ~26 lines are navigation or scoping. Matches the lean-and-efficient anchor. Not 4 because there is no over-explanation to trim anywhere in the body.

5 / 5

Actionability

Guidance is pointer-shaped — "Follow `phases/quick-deploy.md`", "Load `knowledge-packs/frameworks/<framework>.md` per detected framework", "`templates/` (dockerfiles/, k8s/, github-actions/, mermaid/)" — with prerequisites (`az login`, `kubectl`) but no executable command or step for the core deploy task in the body itself. Not 4 because nothing in the body is copy-paste executable; not 2 because the pointers and prerequisites are specific and correctly targeted.

3 / 5

Workflow Clarity

A rough sequence exists — prerequisites, "Follow `phases/quick-deploy.md`", "On failure: `references/rollback.md`" — but validation checkpoints are only implicit (verification is mentioned in the description, never as a body step) and the actual step sequence is delegated to a file absent from the bundle. Matches the steps-listed-but-checkpoints-missing anchor. Not 4 because no explicit validate/verify step appears in the body.

3 / 5

Progressive Disclosure

The References section is well signaled with one-line descriptions ("[safeguards.md](./references/safeguards.md) — DS001-DS013 checklist"), but the primary workflow pointer `phases/quick-deploy.md` plus `knowledge-packs/frameworks/` and `templates/` do not exist in the provided bundle, so the skill's main navigation path dangles. Not 4 because missing referenced paths are a navigation failure beyond "minor organization gaps"; not 2 because the references/ files that do exist are clearly organized one level deep.

3 / 5

Total

14

/

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.

The description is exemplary: third-person concrete actions, an explicit WHEN clause with natural trigger phrases and synonyms, and explicit negative boundaries naming sibling skills to prevent mis-triggering. It is dense but not padded — every clause serves triggering or scoping.

DimensionReasoningScore

Specificity

"Detects the framework, generates a Dockerfile and Kubernetes manifests, validates against AKS Deployment Safeguards, and deploys with verification" lists four concrete actions covering the full detect→generate→validate→deploy→verify lifecycle, matching the comprehensive-coverage anchor. Not 4 because there are no coverage gaps across the deployment workflow.

5 / 5

Completeness

The 'what' is explicit ("Detects the framework, generates a Dockerfile and Kubernetes manifests, validates... and deploys with verification") and the 'when' is explicit via the WHEN: clause with concrete trigger phrases, plus a DO NOT USE FOR boundary — the anchor-5 pattern. Not 4 because both what and when are fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural user phrasings like "my AKS deployment is failing safeguard checks", "I have a Django/Express/Spring Boot app to run on AKS", and "set up CI/CD for AKS" appear alongside synonyms (AKS, K8s, Kubernetes, Azure) and concrete framework names, matching the comprehensive synonym coverage anchor. Not 4 because common variations users would actually say are already well represented.

5 / 5

Distinctiveness Conflict Risk

"DO NOT USE FOR: creating or provisioning an AKS cluster (use azure-kubernetes), assessing migration to AKS Automatic..., or deploying to non-AKS targets like Web Apps, Container Apps, or Functions" explicitly disambiguates sibling skills, and the niche (deploy apps to an already-running AKS cluster) has distinct triggers. Not 4 because conflict risk with adjacent skills is actively resolved by named exclusions.

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/azure-kubernetes-app-deploy/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.