AMR Migration Skill

An Open Agent Skill to help users migrate from Azure Cache for Redis to Azure Managed Redis (AMR).

Overview

This skill assists AI agents in helping users:

• Compare features between Azure Cache for Redis and Azure Managed Redis
• Select appropriate AMR SKUs based on existing ACR cache configurations
• Plan and execute migrations with best practices
• Troubleshoot common migration issues

Usage

Load this skill into your AI agent (GitHub Copilot CLI, Claude, etc.) to get assistance with Azure Redis migration tasks.

With GitHub Copilot CLI

Option A: Using the Vercel Skills CLI (npx skills)

npx skills add https://github.com/AzureManagedRedis/amr-migration-skill -g -a github-copilot

• -g installs the skill globally (personal skill, shared across projects)
• -a github-copilot targets the GitHub Copilot CLI skills directory (~/.copilot/skills/)

⚠️ Important: When prompted for the installation method, choose "Copy to all agents" instead of the symlink option. On Windows, symlink creation requires either Administrator privileges or Developer Mode to be enabled.

Then reload and verify:

/skills reload
/skills info amr-migration-skill

Option B: Clone and Copy

git clone https://github.com/AzureManagedRedis/amr-migration-skill

Windows (PowerShell):

New-Item -ItemType Directory -Path "$env:USERPROFILE\.copilot\skills\amr-migration-skill" -Force
Copy-Item -Path ".\amr-migration-skill\*" -Destination "$env:USERPROFILE\.copilot\skills\amr-migration-skill\" -Recurse

macOS / Linux:

mkdir -p ~/.copilot/skills/amr-migration-skill
cp -r ./amr-migration-skill/* ~/.copilot/skills/amr-migration-skill/

Then reload and verify:

/skills reload
/skills info amr-migration-skill

You should see Source: Personal and the location pointing to ~/.copilot/skills/amr-migration-skill/SKILL.md.

Troubleshooting

• Run /skills reload to refresh without restarting the CLI.
• Verify SKILL.md exists at ~/.copilot/skills/amr-migration-skill/SKILL.md.
• If you used the Vercel CLI with symlinks and the skill isn't found, re-run with the copy method or manually copy the files from ~/.agents/skills/ to ~/.copilot/skills/.

With Claude Code

# Add to your agent skills directory

Example Prompts

Try these prompts to get started:

Migration Planning

• "I have an Azure Cache for Redis Standard C3 in westus2. Help me migrate to Azure Managed Redis."
• "We're running a Premium P2 cache with 3 shards and geo-replication. What's the best AMR SKU and migration strategy?"

SKU Selection & Pricing

• "Compare AMR SKU options for a workload currently using 10GB of memory with high server load."
• "What's the monthly cost difference between my current Standard C2 and the equivalent AMR SKU in eastus?"

Feature Comparison

• "What Redis features does AMR support that ACR doesn't? We need JSON and Search modules."
• "Does AMR support VNet injection? We currently use that on our Premium cache."

Metrics & Assessment

• "Pull the metrics from my ACR cache my-cache in resource group my-rg and recommend an AMR SKU."
• "Assess our current cache usage and give me a full migration plan with pricing."

Retirement & Timeline

• "When is Azure Cache for Redis being retired? What's the timeline for Basic/Standard/Premium?"

Quick Questions

• "What port does AMR use? Our app currently connects on 6380."
• "What changes do I need to make to my connection string when moving to AMR?"

Skill Structure

amr-migration-skill/
├── SKILL.md              # Main skill definition and instructions
├── README.md             # This file
├── TODO.md               # Roadmap items
├── references/
│   ├── azure-cli-commands.md    # Azure CLI reference for ACR discovery
│   ├── feature-comparison.md    # ACR vs AMR feature matrix
│   ├── mcp-server-config.md     # MCP server setup for live documentation
│   ├── migration-overview.md    # Migration strategies and guidance
│   ├── pricing-tiers.md         # Pricing calculation rules
│   ├── retirement-faq.md        # ACR retirement dates and FAQ
│   ├── sku-mapping.md           # SKU selection guidelines & decision matrix
│   └── amr-sku-specs.md         # AMR SKU definitions (M, B, X, Flash series)
└── scripts/
    ├── get_acr_metrics.ps1      # Pull ACR metrics for SKU sizing
    ├── get_acr_metrics.sh
    ├── get_redis_price.ps1      # Pricing with HA/shards/MRPP logic
    └── get_redis_price.sh

External Resources

This skill leverages:

• Microsoft Learn MCP Server: https://learn.microsoft.com/api/mcp for up-to-date Azure documentation
• SKU Mapping Data: Internal spreadsheet (requires updates to references/sku-mapping.md)
• Azure CLI Reference: references/azure-cli-commands.md

Contributing

1. Keep documentation up-to-date with latest Azure Redis features
2. Update SKU mappings when new AMR SKUs are released
3. Add scripts for common migration automation tasks

License

MIT