Back to Skills
Skill

azure-migrate

Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building, debugging, or optimizing Azure Migrate applications. Not for Azure Database Migration service (use azure-database-migration), Azure Site Recovery (use azure-site-recovery), Azure Virtual Machines (use azure-virtual-machines), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

From azure
Install
1
Run in your terminal
$
npx claudepluginhub atc-net/atc-agentic-toolkit
Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Azure Migrate Skill

This skill provides expert guidance for Azure Migrate. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question This skill requires network access to fetch documentation content. Use mcp_microsoftdocs:microsoft_docs_fetch to retrieve full articles.

  • Fallback: Use the built-in WebFetch tool if the Microsoft Learn MCP server is not available.

Category Index

CategoryLinesDescription
TroubleshootingL37-L54Diagnosing and fixing Azure Migrate issues: appliance setup, discovery/assessment errors, replication and migration failures, connectivity, performance, OS upgrade, and web app migration problems.
Best PracticesL55-L65Best practices for preparing on-prem/VMware/legacy Windows workloads and PostgreSQL for Azure migration, securing the Azure Migrate appliance, and running/validating test VM migrations.
Decision MakingL66-L107Guidance on interpreting Azure Migrate assessments, sizing and cost decisions, migration wave planning, and choosing approaches/tools for moving workloads from on-prem, AWS, and GCP to Azure.
Architecture & Design PatternsL108-L113Architecture and data flow for Azure Migrate using Arc-based discovery and Hyper-V, including components, connectivity, prerequisites, and how discovery/inventory works.
Limits & QuotasL114-L127Azure Migrate region support, appliance prerequisites/capacity, and detailed support matrices/limitations for VMware, Hyper-V, and physical server discovery and migration
SecurityL128-L143Securing Azure Migrate: least-privilege roles/accounts, Private Link-based discovery/migration, encryption & CMK for VMs, RBAC setup, and security risk detection with Insights.
ConfigurationL144-L174Configuring Azure Migrate appliances, assessments, dependencies, Arc/agents, credentials, networking, and destination settings for VM, SQL, .NET/Java, and PostgreSQL migration scenarios.
Integrations & Coding PatternsL175-L182Code-level integration patterns: using AppCAT CLI, CAST Highlight, GitHub Copilot insights, and Site Recovery REST APIs to assess and automate VMware-to-Azure app migrations.
DeploymentL183-L190Guides for executing migration waves, setting up DevOps pipelines for containers, and checking support matrices for moving VMs and SQL resources between Azure regions.

Troubleshooting

TopicURL
Diagnose and troubleshoot Azure Migrate appliancehttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-appliance-diagnostic?view=migrate
Troubleshoot Azure Migrate appliance deployment problemshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-appliance?view=migrate
FAQ for troubleshooting Azure Migrate assessmentshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-assessment-faq?view=migrate
Troubleshooting scenarios for Azure Migrate assessmentshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-assessment-supported-scenarios?view=migrate
Resolve common Azure Migrate assessment issueshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-assessment?view=migrate
Fix replication failures in agentless VMware migrationhttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-changed-block-tracking-replication?view=migrate
Troubleshoot Azure Migrate dependency analysis issueshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-dependencies?view=migrate
Troubleshoot Azure Migrate server and SQL discoveryhttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-discovery?view=migrate
Troubleshoot common Azure Migrate service issueshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-general?view=migrate
Troubleshoot Azure Migrate private endpoint connectivityhttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-network-connectivity?view=migrate
Troubleshoot Azure Migrate project creation issueshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-project?view=migrate
Troubleshoot slow or stuck VMware agentless migrationhttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-replication-vmware?view=migrate
Troubleshoot Windows OS upgrade in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-upgrade?view=migrate
Troubleshoot Azure Migrate web app migration issueshttps://learn.microsoft.com/en-us/azure/migrate/troubleshoot-webapps-migration?view=migrate

Best Practices

TopicURL
Apply PostgreSQL assessment rules for Azure migrationhttps://learn.microsoft.com/en-us/azure/migrate/assessment-rules-for-postgresql?view=migrate
Apply security best practices to Azure Migrate appliancehttps://learn.microsoft.com/en-us/azure/migrate/best-practices-security?view=migrate
Best practices for test migrations of virtual machineshttps://learn.microsoft.com/en-us/azure/migrate/how-to-test-replicating-virtual-machines?view=migrate
Use Azure Migrate hydration process for VM configurationhttps://learn.microsoft.com/en-us/azure/migrate/hydration-process?view=migrate
Prepare VMware VMs for agentless migration to Azurehttps://learn.microsoft.com/en-us/azure/migrate/prepare-for-agentless-migration?view=migrate
Prepare on-premises machines for Azure migrationhttps://learn.microsoft.com/en-us/azure/migrate/prepare-for-migration?view=migrate
Prepare Windows Server 2003 workloads for Azure migrationhttps://learn.microsoft.com/en-us/azure/migrate/prepare-windows-server-2003-migration?view=migrate

Decision Making

TopicURL
Interpret AppCAT 7 reports for Java migration readinesshttps://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-interpret-report?view=migrate
Use AppCAT 7 to assess Java apps for Azurehttps://learn.microsoft.com/en-us/azure/migrate/appcat/java?view=migrate
Interpret Azure Migrate assessment report outputshttps://learn.microsoft.com/en-us/azure/migrate/assessment-report?view=migrate
Interpret Azure Migrate business case calculationshttps://learn.microsoft.com/en-us/azure/migrate/concepts-business-case-calculation?view=migrate
Evaluate performance coverage in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/confidence-ratings?view=migrate
Use Azure Migrate assessment cost estimationhttps://learn.microsoft.com/en-us/azure/migrate/cost-estimation?view=migrate
Choose the right Azure Migrate discovery methodhttps://learn.microsoft.com/en-us/azure/migrate/discovery-methods-modes?view=migrate
Build an Azure Migrate business case for servershttps://learn.microsoft.com/en-us/azure/migrate/how-to-build-a-business-case?view=migrate
Build high-fidelity Azure migration execution planshttps://learn.microsoft.com/en-us/azure/migrate/how-to-complete-wave-plan?view=migrate
Create migration waves for Azure Migrate projectshttps://learn.microsoft.com/en-us/azure/migrate/how-to-plan-create-waves?view=migrate
Review Azure Migrate business case reportshttps://learn.microsoft.com/en-us/azure/migrate/how-to-view-a-business-case?view=migrate
Plan migration waves with Azure Migrate Wave Planninghttps://learn.microsoft.com/en-us/azure/migrate/overview?view=migrate
Evaluate readiness and savings for Arc-enabled servershttps://learn.microsoft.com/en-us/azure/migrate/quickstart-evaluate-readiness-savings-for-arc-resources?view=migrate
Review Azure Migrate application assessment strategieshttps://learn.microsoft.com/en-us/azure/migrate/review-application-assessment?view=migrate
Interpret Azure VM assessment results in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/review-assessment?view=migrate
Review Azure VMware Solution assessment outputshttps://learn.microsoft.com/en-us/azure/migrate/review-azure-vmware-solution-assessment?view=migrate
Interpret Azure Files assessment results in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/review-file-share-assessment?view=migrate
Interpret SQL migration assessments in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/review-sql-assessment?view=migrate
Review web app assessment insights for Azure migrationhttps://learn.microsoft.com/en-us/azure/migrate/review-web-app-assessment?view=migrate
Choose agentless vs agent-based migration in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/server-migrate-overview?view=migrate
Choose performance vs as-is sizing in assessmentshttps://learn.microsoft.com/en-us/azure/migrate/target-right-sizing?view=migrate
Review PostgreSQL assessment results in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/tutorial-review-postgresql-report?view=migrate
Plan migration of AWS compute services to Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-compute-from-aws
Select Azure targets for AWS database migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-databases-from-aws
Plan migration of GCP databases to Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-databases-from-google-cloud
Compare AWS and Azure services for migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-from-aws
Compare GCP and Azure services for migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-from-google-cloud
Plan migration from on-premises workloads to Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-from-on-premises
Map AWS networking services to Azure networkinghttps://learn.microsoft.com/en-us/azure/migration/migrate-networking-from-aws
Replatform AWS security services to Microsoft Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-security-from-aws
Choose Azure storage services for AWS migrationshttps://learn.microsoft.com/en-us/azure/migration/migrate-storage-from-aws
Decommission AWS resources after Azure migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-decommission
Evaluate workload health after AWS to Azure migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-evaluate
Execute AWS to Azure workload cutover safelyhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-execute
End-to-end guidance for migrating one AWS workloadhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-introduction
Plan an AWS to Azure workload migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-plan
Prepare AWS workloads and Azure environment for migrationhttps://learn.microsoft.com/en-us/azure/migration/migrate-workload-from-aws-prepare
Choose tools for moving Azure resources across regionshttps://learn.microsoft.com/en-us/azure/resource-mover/select-options-to-move-resources

Architecture & Design Patterns

TopicURL
Understand Arc-based discovery architecture in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/concepts-arc-resource-discovery?view=migrate
Understand Hyper-V migration architecture in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/hyper-v-migration-architecture?view=migrate

Limits & Quotas

TopicURL
Use Azure Migrate in unsupported regionshttps://learn.microsoft.com/en-us/azure/migrate/azure-migrate-unsupported-regions?view=migrate
Scale-out Azure Migrate appliance capacity limitshttps://learn.microsoft.com/en-us/azure/migrate/how-to-scale-out-for-migration?view=migrate
Review Azure Migrate appliance prerequisites and supporthttps://learn.microsoft.com/en-us/azure/migrate/migrate-appliance?view=migrate
Hyper-V to Azure migration support matrixhttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-hyper-v-migration?view=migrate
Review Hyper-V assessment support in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-hyper-v?view=migrate
Review physical server discovery support in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-physical?view=migrate
VMware to Azure migration support matrix detailshttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-vmware-migration?view=migrate
Check VMware discovery support matrix for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-vmware?view=migrate
Review Azure Migrate support matrix and limitationshttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix?view=migrate
Check Azure Migrate supported geographies and regionshttps://learn.microsoft.com/en-us/azure/migrate/supported-geographies?view=migrate

Security

TopicURL
Configure least-privilege VMware roles for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/best-practices-least-privileged-account?view=migrate
Configure Azure Migrate discovery over Private Linkhttps://learn.microsoft.com/en-us/azure/migrate/discover-and-assess-using-private-endpoints?view=migrate
Discover and assess servers via Azure Private Linkhttps://learn.microsoft.com/en-us/azure/migrate/discover-and-assess-using-private-endpoints?view=migrate
Migrate VMware VMs with SSE and customer-managed keyshttps://learn.microsoft.com/en-us/azure/migrate/how-to-migrate-vmware-vms-with-cmk-disks?view=migrate
Register Azure Migrate appliance using Entra ID apphttps://learn.microsoft.com/en-us/azure/migrate/how-to-register-appliance-using-entra-app?view=migrate
Use Azure Migrate Insights for security risk detectionhttps://learn.microsoft.com/en-us/azure/migrate/insights-overview?view=migrate
Create minimal-permission SQL account for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/least-privilege-credentials?view=migrate
Migrate Hyper-V servers using Private Link endpointshttps://learn.microsoft.com/en-us/azure/migrate/migrate-hyper-v-servers-to-azure-using-private-link?view=migrate
Configure least-privilege PostgreSQL account for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/postgresql-least-privilege-configuration?view=migrate
Configure Azure RBAC roles for Azure Migrate projectshttps://learn.microsoft.com/en-us/azure/migrate/prepare-azure-accounts?view=migrate
Scope VMware discovery using vCenter permissionshttps://learn.microsoft.com/en-us/azure/migrate/set-discovery-scope?view=migrate
Move encrypted Azure VMs between regions with Resource Moverhttps://learn.microsoft.com/en-us/azure/resource-mover/tutorial-move-region-encrypted-virtual-machines

Configuration

TopicURL
Configure server credentials on Azure Migrate appliancehttps://learn.microsoft.com/en-us/azure/migrate/add-server-credentials?view=migrate
Develop custom YAML rules for AppCAT 7https://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-rule-guide?view=migrate
Configure AppCAT for .NET application migration assessmentshttps://learn.microsoft.com/en-us/azure/migrate/appcat/dotnet?view=migrate
Use legacy AppCAT Java tool to assess migration readinesshttps://learn.microsoft.com/en-us/azure/migrate/appcat/java-6?view=migrate
Meet prerequisites for Azure Migrate assessmentshttps://learn.microsoft.com/en-us/azure/migrate/assessment-prerequisites?view=migrate
Configure general assessment properties in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/assessment-properties?view=migrate
Migrate dependency analysis from MMA to Azure Monitor Agenthttps://learn.microsoft.com/en-us/azure/migrate/azure-monitor-agent-migration?view=migrate
Prepare RVTools XLSX for Azure Migrate importhttps://learn.microsoft.com/en-us/azure/migrate/common-questions-import?view=migrate
Set up Azure Migrate appliance in Azure Governmenthttps://learn.microsoft.com/en-us/azure/migrate/deploy-appliance-script-government?view=migrate
Deploy Azure Migrate appliance via PowerShell scripthttps://learn.microsoft.com/en-us/azure/migrate/deploy-appliance-script?view=migrate
Understand Azure Migrate discovered metadata fieldshttps://learn.microsoft.com/en-us/azure/migrate/discovered-metadata?view=migrate
Enable Azure Arc for servers discovered by Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/how-to-arc-enable-inventory?view=migrate
Configure agentless dependency analysis in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/how-to-create-group-machine-dependencies-agentless?view=migrate
Configure agent-based dependency analysis in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/how-to-create-group-machine-dependencies?view=migrate
Discover SQL Server instances in existing Migrate projectshttps://learn.microsoft.com/en-us/azure/migrate/how-to-discover-sql-existing-project?view=migrate
Enable extra data collection on Arc-enabled servershttps://learn.microsoft.com/en-us/azure/migrate/how-to-enable-additional-data-collection-for-arc-servers?view=migrate
Manage Arc resource synchronization in Azure Migrate projectshttps://learn.microsoft.com/en-us/azure/migrate/how-to-manage-arc-resource-sync?view=migrate
Configure Azure Migrate appliance for physical servershttps://learn.microsoft.com/en-us/azure/migrate/how-to-set-up-appliance-physical?view=migrate
Configure in-place Windows Server OS upgrade during migrationhttps://learn.microsoft.com/en-us/azure/migrate/how-to-upgrade-windows?view=migrate
Use Azure Migrate over Private Link with private endpointshttps://learn.microsoft.com/en-us/azure/migrate/how-to-use-azure-migrate-with-private-endpoints?view=migrate
Reference for Azure Migrate Collector VM extension settingshttps://learn.microsoft.com/en-us/azure/migrate/migrate-virtual-machine-extension-reference?view=migrate
Use built-in Azure Policy definitions for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/policy-reference?view=migrate
Configure PostgreSQL assessment properties in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/postgresql-assessment-properties?view=migrate
Create Azure Migrate project using ARM templatehttps://learn.microsoft.com/en-us/azure/migrate/quickstart-create-migrate-project?view=migrate
Set Azure VM assessment properties in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/vm-assessment-properties?view=migrate
Manage resources created during VM move with Resource Moverhttps://learn.microsoft.com/en-us/azure/resource-mover/manage-resources-created-move-process
Configure destination settings for VM moves with Resource Moverhttps://learn.microsoft.com/en-us/azure/resource-mover/modify-target-settings

Integrations & Coding Patterns

TopicURL
Add GitHub Copilot code insights to web app assessmentshttps://learn.microsoft.com/en-us/azure/migrate/add-copilot-code-insights?view=migrate
Use AppCAT 7 CLI commands for Java assessmentshttps://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-cli-guide?view=migrate
Integrate CAST Highlight code scans with Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/cast-highlights-integration?view=migrate
Automate VMware to Azure migration with Site Recovery REST APIhttps://learn.microsoft.com/en-us/azure/migrate/how-to-automate-vmware-to-azure-migration-rest-api?view=migrate

Deployment

TopicURL
Execute and track migration waves in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/how-to-execute-track-waves?view=migrate
Configure Azure DevOps pipelines for containerized appshttps://learn.microsoft.com/en-us/azure/migrate/tutorial-app-containerization-azure-pipeline?view=migrate
Supported extension resource types in Azure Resource Moverhttps://learn.microsoft.com/en-us/azure/resource-mover/support-matrix-extension-resource-types
Support matrix for moving Azure VMs between regionshttps://learn.microsoft.com/en-us/azure/resource-mover/support-matrix-move-region-azure-vm
Support matrix for moving Azure SQL resources between regionshttps://learn.microsoft.com/en-us/azure/resource-mover/support-matrix-move-region-sql
Similar Skills
ui-ux-pro-max

UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient. Integrations: shadcn/ui MCP for component search and examples.

49.4k
Stats
Parent Repo Stars0
Parent Repo Forks1
Last CommitMar 9, 2026
Actions
View SourceView PluginView on GitHubView README