New to Claude Skills? Learn how to install them →

microsoft on GitHub

Azure Cloud Migrate

OfficialFree

Seamlessly migrate cloud workloads to Azure.

by microsoft1.4k stars on microsoft/azure-skills
3 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Azure Cloud Migrate does

Azure Cloud Migrate is a specialized skill designed to facilitate the assessment and migration of existing cloud workloads to Microsoft Azure. This tool is particularly beneficial for developers and organizations looking to transition applications from various cloud environments, including AWS and Google Cloud, to Azure's robust infrastructure. The skill provides a structured approach to migration, ensuring that users can follow a defined sequence of steps without skipping critical phases. It emphasizes the importance of generating an assessment report before any code migration takes place, allowing for a thorough understanding of the existing application landscape.

The skill supports a variety of migration scenarios, including AWS Lambda to Azure Functions, AWS Elastic Beanstalk to Azure App Service, and Kubernetes to Azure Container Apps, among others. Each migration scenario is accompanied by specific guides that detail the assessment and code conversion processes, ensuring users have access to tailored resources for their particular needs. This targeted approach helps streamline the migration process, reducing potential errors and improving overall efficiency.

In addition to migration capabilities, Azure Cloud Migrate includes features for auditing service discovery in application code, which is crucial for ensuring that hardcoded DNS names and ports are appropriately managed in the new environment. The skill also provides progress updates during long-running operations, keeping users informed and engaged throughout the migration journey. By using this skill, developers can confidently navigate the complexities of cross-cloud migration while leveraging Azure's powerful services.

When to use it

Use this skill when planning to migrate applications from AWS, Google Cloud, or other platforms to Azure, especially when specific migration scenarios are involved.

When not to use it

This skill is not suitable for migrations that do not fit the defined scenarios or for users unfamiliar with cloud migration processes.

What you can build with it

Migrating AWS Lambda Functions

Transition your AWS Lambda functions to Azure Functions using the tailored assessment and migration guides provided.

Moving from Beanstalk to Azure App Service

Utilize the skill to seamlessly migrate applications hosted on AWS Elastic Beanstalk to Azure's App Service.

Kubernetes to Azure Container Apps Migration

Leverage the skill to assess and migrate Kubernetes workloads to Azure Container Apps, ensuring compatibility and efficiency.

How to install Azure Cloud Migrate

View source

1. Install with the skills CLI

npx skills add microsoft/azure-skills/azure-cloud-migrate --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by microsoft

Azure Cloud Migrate

This skill handles assessment and code migration of existing cloud workloads to Azure.

Rules

  1. Follow phases sequentially — do not skip
  2. Generate assessment before any code migration
  3. Load the scenario reference and follow its rules
  4. Use mcp_azure_mcp_get_azure_bestpractices and mcp_azure_mcp_documentation MCP tools
  5. Use the latest supported runtime for the target service
  6. Destructive actions require ask_userfunctions global-rules | app-service global-rules
  7. Report progress to user — During long-running operations (deployments, image pushes), provide resource-level status updates so the user is never left waiting without feedback — see workflow-details.md
  8. Audit service discovery in app code — Kubernetes DNS names (e.g., http://order-service:3001) do not resolve in Container Apps. During assessment, scan source code for hardcoded hostnames/ports in HTTP clients and flag them for env-var-driven URL injection

Migration Scenarios

SourceTargetReference
AWS LambdaAzure Functionslambda-to-functions.md (assessment, code-migration)
AWS Elastic BeanstalkAzure App Servicebeanstalk-to-app-service.md
HerokuAzure App Serviceheroku-to-app-service.md
Google App EngineAzure App Serviceapp-engine-to-app-service.md
AWS Fargate (ECS)Azure Container Appsfargate-to-container-apps.md (assessment, deployment)
Kubernetes (GKE/EKS/Self-hosted)Azure Container Appsk8s-to-container-apps.md
GCP Cloud RunAzure Container Appscloudrun-to-container-apps.md
Spring Boot (Azure Spring Apps/VMs)Azure Container Appsspring-apps-to-aca.md

No matching scenario? Use mcp_azure_mcp_documentation and mcp_azure_mcp_get_azure_bestpractices tools.

Output Directory

All output goes to <workspace-root-basename>-azure/ at workspace root, where <workspace-root-basename> is the name of the top-level workspace directory itself (NOT a subdirectory within it). Never modify the source directory.

Steps

  1. Create <workspace-root-basename>-azure/ at workspace root
  2. Assess — Analyze source, map services, generate report using the scenario-specific assessment guide → functions assessment | app-service assessment
  3. Migrate — Convert code/config using the scenario-specific migration guide → functions code-migration | app-service code-migration
  4. Ask User — "Migration complete. Test locally or deploy to Azure?"
  5. Hand off to azure-prepare for infrastructure, testing, and deployment

Track progress in migration-status.md — see workflow-details.md.

Frequently asked questions about Azure Cloud Migrate

Similar skills