About azure-migrate
azure-migrate is a guidance skill for agents working with Azure Migrate. It combines local reference material with remote documentation retrieval across migration planning, configuration, security, deployment, and troubleshooting.
Key features
- 01Troubleshooting and configuration guidance
- 02Assessment and migration planning
- 03Architecture, limits, and security references
- 04Local reference with remote documentation fetching
Use cases
- 01Diagnosing appliance, discovery, or replication issues
- 02Choosing migration methods and sizing workloads
- 03Preparing secure Azure Migrate deployments
MCP support
The skill recommends using mcp_microsoftdocs:microsoft_docs_fetch to retrieve documentation, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/azure-migratein Claude Code to confirm it loaded.
Details
From the project READMEAzure 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L55 | Diagnosing and fixing Azure Migrate issues: appliance setup, discovery/dependency/assessment errors, project creation, private endpoints, VMware replication, OS upgrades, and web app migrations. |
| Best Practices | L56-L66 | Best practices for preparing on-prem/VMware machines and appliances, creating custom assessment rules (AppCAT, PostgreSQL), running test migrations, and applying pre-migration hydration changes. |
| Decision Making | L67-L107 | Guidance for interpreting Azure Migrate assessments, choosing tools and sizing, planning migration waves, and deciding services/VM types for on-prem, AWS, GCP, and Java workloads. |
| Architecture & Design Patterns | L108-L113 | Architecture and data flow for Azure Migrate using Arc-based discovery and Hyper-V, including components, connectivity, prerequisites, and how discovery/inventory works. |
| Limits & Quotas | L114-L126 | Limits, prerequisites, region support, and scalability for Azure Migrate appliances and discovery/assessment of VMware, Hyper-V, and physical servers. |
| Security | L127-L139 | Securing Azure Migrate: least-privilege roles/accounts, RBAC, Private Link usage, SSE + customer-managed keys, Entra ID app registration, and moving encrypted VMs securely. |
| Configuration | L140-L165 | Configuring Azure Migrate appliances, credentials, networking (Private Link), Arc/Resource Mover, and assessment settings for VMs, SQL, .NET, and PostgreSQL, plus metadata and policy setup. |
| Integrations & Coding Patterns | L166-L171 | Patterns 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. |
| Deployment | L172-L182 | Guides 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
Best Practices
| Topic | URL |
|---|---|
| Develop custom YAML rules for AppCAT 7 assessments | https://learn.microsoft.com/en-us/azure/migrate/appcat/appcat-7-rule-guide?view=migrate |
| Apply PostgreSQL assessment rules for Azure migration | https://learn.microsoft.com/en-us/azure/migrate/assessment-rules-for-postgresql?view=migrate |
| Apply security best practices to Azure Migrate appliance | https://learn.microsoft.com/en-us/azure/migrate/best-practices-security?view=migrate |
| Best practices for test migrations of virtual machines | https://learn.microsoft.com/en-us/azure/migrate/how-to-test-replicating-virtual-machines?view=migrate |
| Apply Azure Migrate hydration changes before migration | https://learn.microsoft.com/en-us/azure/migrate/hydration-process?view=migrate |
| Prepare VMware VMs for agentless migration to Azure | https://learn.microsoft.com/en-us/azure/migrate/prepare-for-agentless-migration?view=migrate |
| Prepare on-premises machines for Azure migration | https://learn.microsoft.com/en-us/azure/migrate/prepare-for-migration?view=migrate |
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Understand Arc-based discovery architecture in Azure Migrate | https://learn.microsoft.com/en-us/azure/migrate/concepts-arc-resource-discovery?view=migrate |
| Understand Hyper-V migration architecture in Azure Migrate | https://learn.microsoft.com/en-us/azure/migrate/hyper-v-migration-architecture?view=migrate |
Limits & Quotas
Security
Configuration
Integrations & Coding Patterns
| Topic | URL |
|---|---|
| Integrate CAST Highlight code scans with Azure Migrate | https://learn.microsoft.com/en-us/azure/migrate/cast-highlights-integration?view=migrate |
| Automate VMware to Azure migration via Site Recovery REST | https://learn.microsoft.com/en-us/azure/migrate/how-to-automate-vmware-to-azure-migration-rest-api?view=migrate |