aks-manifest-migrate

name	aks-manifest-migrate
description	Rewrite vanilla Kubernetes manifests or Helm charts toward AKS best practices. Use for: migrate manifests to aks, migrate helm chart to aks, convert loadbalancer to aks ingress, add workload identity, harden kubernetes for aks.
license	MIT
metadata	{"author":"GitHub Copilot","version":"0.1.0"}

AKS Manifest Migration

Use this skill after assessment is complete.

When To Use

Activate this skill when the user wants to:

• migrate plain manifests to an AKS-oriented baseline
• migrate a Helm chart to AKS-friendly defaults
• replace static credentials with Workload Identity wiring
• shift HTTP exposure away from direct LoadBalancer services
• add operational safety controls required for AKS production workloads

Rules

1. Never mutate the source directory. Write outputs to the -aks directory defined by the assessment skill.
2. Preserve business behavior while tightening platform behavior.
3. For HTTP workloads, prefer Service type ClusterIP plus AKS application routing ingress unless a direct LoadBalancer is required.
4. Prefer Microsoft Entra Workload ID over embedded credentials or pod-managed identity.
5. Add AKS workload hardening as first-class resources:
   • requests and limits
   • startup, readiness, and liveness probes
   • HPA
   • PDB
   • topology spread
   • network policy
6. Keep the output CRD-light by default. If Gateway API, service mesh, or Secrets Store CSI Driver are needed, document that dependency explicitly.
7. If the target cluster is already known, use mcp_azure_mcp_aks to confirm the ingress and networking assumptions before finalizing the result.

Workflow

1. Choose the migration path
   • raw manifest path
   • Helm chart path
2. Apply the rewrite rules in references/migration-rules.md
3. Apply the Helm-specific guidance in references/helm-guidance.md when the source is a chart
4. Generate AKS target artifacts under the -aks output directory
5. Run aks-migration-harness before claiming completion

References

• references/migration-rules.md
• references/helm-guidance.md