skills/ MicrosoftDocs/Agent-Skills

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 sizing and migrating VMs/SQL/PostgreSQL, configuring appliance

0
Installs
—
Rating
—
Success rate
1
Files scanned
Scan passeddevops
Source on GitHub

Security scan

Scan passed

No risky patterns were found in the scanned files.

1 files scannedscanner v1.2.0Oct 11, 2026

Content sha256 f2cef93572659ea7… — run codexguild_scan_skills after installing to verify your local copy.

Static analysis is a first line of defense, not a guarantee. Read the source

SKILL.md

exact scanned copy

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: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L55Diagnosing and fixing Azure Migrate issues: appliance setup, discovery/assessment errors, dependency analysis, project creation, private endpoints, VMware agentless replication, and OS/web app migration.
Best PracticesL56-L66Best practices for preparing on-prem/VMware machines and appliances, configuring VM hydration, running test migrations, and creating custom/AppCAT/PostgreSQL assessment rules for Azure Migrate.
Decision MakingL67-L106Deciding migration strategies with Azure Migrate/AppCAT: interpreting assessment reports, sizing and readiness, choosing tools/targets, and planning end-to-end migrations from on-prem, AWS, GCP, and VMware.
Architecture & Design PatternsL107-L112Architecture and data flow for Azure Migrate using Arc-based discovery and Hyper-V, including components, connectivity, prerequisites, and how discovery/inventory works.
Limits & QuotasL113-L125Support matrices, prerequisites, limits, regions, and scaling guidance for Azure Migrate appliances and migrations from VMware, Hyper-V, and physical servers.
SecurityL126-L137Securing Azure Migrate: least-privilege roles/accounts, Private Link discovery/migration, encrypted VM moves, Trusted Launch, RBAC, and Entra ID app registration.
ConfigurationL138-L162Configuring Azure Migrate appliances, Arc/agents, assessment settings (VM, SQL, PostgreSQL, .NET), private endpoints, landing zones, and Resource Mover destination/resource settings.
Integrations & Coding PatternsL163-L168Patterns and tools for integrating code analysis and automation into Azure Migrate, including GitHub Copilot insights, AppCAT CLI, CAST Highlight scans, and REST-based VMware migration.
DeploymentL169-L179Guides for deploying Azure Migrate appliances, preparing legacy servers, configuring DevOps pipelines, and planning/executing cross-region VM and SQL moves with supported resource types.

Troubleshooting

TopicURL
Resolve Azure Migrate discovery and dependency issueshttps://learn.microsoft.com/en-us/azure/migrate/common-questions-discovery-dependency-analysis?view=migrate
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
Troubleshoot agentless VMware replication in Azure Migratehttps://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
Develop custom YAML rules for AppCAT 7 assessmentshttps://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-rule-guide?view=migrate
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

Decision Making

TopicURL
Interpret AppCAT 7 Java migration readiness reportshttps://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-interpret-report?view=migrate
Assess Java apps with legacy AppCAT 6 enginehttps://learn.microsoft.com/en-us/azure/migrate/appcat/java-6?view=migrate
Decide when to use AppCAT 7 for Java migrationshttps://learn.microsoft.com/en-us/azure/migrate/appcat/java?view=migrate
Configure Azure Migrate assessment general propertieshttps://learn.microsoft.com/en-us/azure/migrate/assessment-properties?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
Choose the right Azure Migrate discovery methodhttps://learn.microsoft.com/en-us/azure/migrate/discovery-methods-modes?view=migrate
Use Azure Migrate to build a migration business casehttps://learn.microsoft.com/en-us/azure/migrate/how-to-build-a-business-case?view=migrate
Plan VMware-to-Azure migrations with Copilot agenthttps://learn.microsoft.com/en-us/azure/migrate/how-to-plan-analyze-migration-with-agent?view=migrate
Plan Azure network components with Migrate assessmentshttps://learn.microsoft.com/en-us/azure/migrate/network-assessment?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
Interpret and review Azure VM migration assessmentshttps://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 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
Select supported geographies for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/supported-geographies?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
Choose Azure compute equivalents for AWS workloadshttps://learn.microsoft.com/en-us/azure/migration/migrate-compute-from-aws
Select Azure database services for AWS migrationshttps://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
Select Azure services when migrating from AWShttps://learn.microsoft.com/en-us/azure/migration/migrate-from-aws
Choose Azure services when migrating on-premises workloadshttps://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
Plan migration of AWS security services to Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-security-from-aws
Plan and execute single-workload migrations to Azurehttps://learn.microsoft.com/en-us/azure/migration/migrate-to-azure
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 for large VMware moveshttps://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 discovery and assessment support matrix in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-hyper-v?view=migrate
Understand physical server discovery and assessment support limits in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-physical?view=migrate
Support matrix and limits for VMware vSphere migrationhttps://learn.microsoft.com/en-us/azure/migrate/migrate-support-matrix-vmware-migration?view=migrate
Check VMware discovery prerequisites and support limits in 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

Security

TopicURL
Configure least-privilege VMware roles for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/best-practices-least-privileged-account?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
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
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 Azure Migrate appliance server credentialshttps://learn.microsoft.com/en-us/azure/migrate/add-server-credentials?view=migrate
Use AppCAT 7 CLI commands and optionshttps://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-cli-guide?view=migrate
Configure AppCAT for .NET application migration assessmentshttps://learn.microsoft.com/en-us/azure/migrate/appcat/dotnet?view=migrate
Meet Azure Migrate assessment prerequisites and settingshttps://learn.microsoft.com/en-us/azure/migrate/assessment-prerequisites?view=migrate
Migrate dependency analysis from MMA to Azure Monitor Agenthttps://learn.microsoft.com/en-us/azure/migrate/azure-monitor-agent-migration?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
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
Register Azure Migrate appliance via Azure Arc agenthttps://learn.microsoft.com/en-us/azure/migrate/how-to-register-appliance-using-arc-agent?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 Azure Migrate with Private Endpoints and Private Linkhttps://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
Configure Azure Migrate Platform Landing Zone settingshttps://learn.microsoft.com/en-us/azure/migrate/platform-landing-zone?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
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 via Site Recovery RESThttps://learn.microsoft.com/en-us/azure/migrate/how-to-automate-vmware-to-azure-migration-rest-api?view=migrate

Deployment

TopicURL
Deploy Azure Migrate appliance in Azure Governmenthttps://learn.microsoft.com/en-us/azure/migrate/deploy-appliance-script-government?view=migrate
Deploy Azure Migrate appliance using PowerShell scripthttps://learn.microsoft.com/en-us/azure/migrate/deploy-appliance-script?view=migrate
Execute and track migration waves in Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/how-to-execute-track-waves?view=migrate
Prepare Windows Server 2003 for Azure Migratehttps://learn.microsoft.com/en-us/azure/migrate/prepare-windows-server-2003-migration?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
Check support matrix for cross-region Azure VM moveshttps://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

Files

1
20.4 KB

Agent reviews

0

No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.

More from MicrosoftDocs/Agent-Skills8

azure-active-directory-b2c

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configur

Scan passed 0
azure-advisor

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts/digests, managing rec states, using workbooks, Resource Graph, or RBAC for access, and other Azu

Scan passed 0
azure-ai-vision

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Visio

Scan passed 0
azure-aks-edge-essentials

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing AKS Edge/Hybrid with Arc,

Scan passed 0
azure-analysis-services

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-

Scan passed 0
azure-anomaly-detector

Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment. Use when tuning Docker-based Anomaly Detector, ACI or IoT Edge deployments, univariate/multivariate APIs, or service limits, and other Azure AI Anomal

Scan passed 0
azure-anyscale-on-azure

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, and deployment. Use when authoring ARM templates, hardening images, configuring Private Link, or checking Anyscale regional availability, and other Azure Anyscale On Azure related development

Scan passed 0
azure-api-center

Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when setting API auth, provisioning API Center, automating linting/registration, self-hosting the portal, or syncing with API gateways, and other A

Scan passed 0

Related devops skillsscan passed

setup-deploy

Configure deployment settings for /land-and-deploy.

Scan passed 0
enterprise-agent-ops

Operational controls for long-lived or cloud-hosted agent systems — runtime lifecycle (start, pause, stop, restart), observability (logs, metrics, traces), least-privilege safety scopes and kill switches, and rollout/rollback change management with audit logs and success/cost metrics. Use when runni

Scan passed 0
cloudflare-email-service

Implement or troubleshoot Cloudflare Email Sending and Email Routing integrations and their delivery configuration.

Scan passed 0
adapter-aws-lambda

Deploy tRPC on AWS Lambda with awsLambdaRequestHandler() from @trpc/server/adapters/aws-lambda for API Gateway v1 (REST, APIGatewayProxyEvent) and v2 (HTTP, APIGatewayProxyEventV2), and Lambda Function URLs. Enable response streaming with awsLambdaStreamingRequestHandler() wrapped in awslambda.strea

Scan passed 0
ci-cd-and-automation

Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.

Scan passed 0
firebase-hosting-basics

Deploys and configures classic Firebase Hosting for static websites, single-page apps (SPAs), and microservices. Use when deploying static sites/SPAs, setting up custom domains, configuring firebase.json hosting settings (redirects, rewrites, headers, multi-site), or managing preview channels. Don't

Scan passed 0