azure-kubernetes-app-deploy — Claude Code skill: how to install
Containerizes web apps and APIs to deploy them directly onto an active Azure Kubernetes Service cluster. Validates manifests against AKS Deployment Safeguards.
npx skills add microsoft/skills --skill azure-kubernetes-app-deploy -a claude-codeWhat azure-kubernetes-app-deploy does
The skill detects project frameworks, resolves base container images, and crafts Dockerfiles alongside Kubernetes manifests. It includes profiles for Spring Boot, Express, Next.js, FastAPI, Django, NestJS, ASP.NET Core, Go, and Flask. Workload Identity setups and GitHub Actions workflow templates come bundled as well.
Before launching workloads, it verifies configuration against AKS Deployment Safeguards checklist items DS001 through DS013. When automated checks fail or a release breaks, recovery instructions help roll back changes.
This skill requires an active AKS cluster, configured kubectl, and an authenticated az login session. It cannot build infrastructure from scratch. Cluster provisioning belongs to the separate azure-kubernetes skill.
What it helps with
- containerize backend APIs and web applications with generated Dockerfiles
- build Kubernetes manifests matching framework networking and health checks
- pass AKS Deployment Safeguards validation across rules DS001 to DS013
- configure Workload Identity and automated delivery via GitHub Actions
Example prompts for the agent
- Generate a Dockerfile and Kubernetes manifests to run this Django app on AKS
- Inspect our deployment manifests against AKS Deployment Safeguards DS001-DS013
- Configure GitHub Actions workflows to deploy this service to our existing AKS cluster
How to install azure-kubernetes-app-deploy
1Skills CLI (Vercel)
npx skills add microsoft/skills --skill azure-kubernetes-app-deploy -a claude-code2Manually: put the files in place
~/.claude/skills/azure-kubernetes-app-deploy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-kubernetes-app-deploy/
Manually: put the files in place
.agents/skills/azure-kubernetes-app-deploy/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/azure-kubernetes-app-deploy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install microsoft/skills azure-kubernetes-app-deploy2Manually: put the files in place
.github/skills/azure-kubernetes-app-deploy/SKILL.mdPlatform CLI
gemini skills install https://github.com/microsoft/skills --path .github/plugins/azure-skills/skills/azure-kubernetes/azure-kubernetes-app-deployManually: put the files in place
.devin/skills/azure-kubernetes-app-deploy/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-kubernetes-app-deploy
How to install azure-kubernetes-app-deploy in Claude Code?
Run npx skills add microsoft/skills --skill azure-kubernetes-app-deploy -a claude-code in your terminal. You can also place the specification directly at ~/.claude/skills/azure-kubernetes-app-deploy/SKILL.md.
What does azure-kubernetes-app-deploy do?
It inspects code to detect the web framework, generates Dockerfiles and Kubernetes manifests, validates them against AKS Deployment Safeguards, and verifies the deployment.
Can azure-kubernetes-app-deploy create a new AKS cluster?
No, it works only with existing clusters. Provisioning must be handled separately using the azure-kubernetes skill, and your local environment needs az login and kubectl ready.
Source text
SKILL.md · MIT
--- name: azure-kubernetes-app-deploy license: MIT metadata: author: Microsoft version: "1.0.0" description: "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." --- # Deploy to AKS **Use when:** deploying a web app/API to AKS; containerizing for Kubernetes; generating manifests; AKS CI/CD; DS001–DS013 failures. **Not for:** provisioning clusters (`azure-kubernetes`), AKS Automatic readiness (`azure-kubernetes-automatic-readiness`), non-AKS targets. ## Workflow Requires: existing AKS cluster, `az login`, `kubectl` configured. Follow `phases/quick-deploy.md`. On failure: `references/rollback.md`. ## References - [detection.md](./references/detection.md) — framework/port/health detection - [safeguards.md](./references/safeguards.md) — DS001-DS013 checklist - [workload-identity.md](./references/workload-identity.md) — Workload Identity setup - [rollback.md](./references/rollback.md) — recovery procedures - [base-images.md](./references/base-images.md) — base image policy and `<LATEST_STABLE_*>` resolution ## Knowledge Packs Load `knowledge-packs/frameworks/<framework>.md` per detected framework. Available: `spring-boot`, `express`, `nextjs`, `fastapi`, `django`, `nestjs`, `aspnet-core`, `go`, `flask` ## Templates `templates/` (dockerfiles/, k8s/, github-actions/, mermaid/).
© Microsoft · MIT · microsoft/skills
