ACRE to AMR Migration Skill

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

Overview

This skill assists AI agents in helping users:

• Understand what changes are required in their automation scripts (ARM templates, Bicep templates, Azure CLI, Azure PowerShell) after migrating from ACRE to AMR
• Get step-by-step interactive guidance to migrate ACRE caches to AMR, including discovering caches, executing migration with confirmation gates, and handling geo-replicated cache scenarios
• Get a generic recommended step-by-step migration guide or flowchart for ACRE to AMR migration without executing any commands against a live subscription

Usage

Load this skill into your AI agent (GitHub Copilot, Claude Code, etc.) to get assistance with ACRE → AMR migration tasks.

With GitHub Copilot

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

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

• -g installs the skill globally (personal skill, shared across projects)
• -a github-copilot targets the GitHub Copilot 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 acre-to-amr-migration-skill

Option B: Clone and Copy

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

Windows (PowerShell):

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

macOS / Linux:

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

Then reload and verify:

/skills reload
/skills info acre-to-amr-migration-skill

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

Troubleshooting

• Run /skills reload to refresh without restarting the CLI.
• Verify SKILL.md exists at ~/.copilot/skills/acre-to-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

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

npx skills add https://github.com/AzureManagedRedis/acre-to-amr-migration-skill -g -a claude-code

• -g installs the skill globally (personal skill, shared across projects)
• -a claude-code targets the Claude Code skills directory (~/.agents/skills/)

Option B: Clone and Copy

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

Windows (PowerShell):

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

macOS / Linux:

mkdir -p ~/.agents/skills/acre-to-amr-migration-skill
cp -r ./acre-to-amr-migration-skill/* ~/.agents/skills/acre-to-amr-migration-skill/

Verify the skill is detected by asking Claude Code: "What skills do you have access to?"

Example Prompts

Try these prompts to get started:

Automation Script Update

• "I have an ARM template that deploys an ACRE cache — what do I need to change for AMR?"
• "Here's my Bicep template for Redis Enterprise. Can you give me a checklist of changes needed after migrating to AMR?"
• "My Azure CLI script creates an Enterprise_E10 cache with capacity 2. What's the equivalent AMR command?"
• "Review my PowerShell deployment script and tell me what breaks after ACRE to AMR migration."
• "What AMR SKU should I use to replace my Enterprise_E20 with capacity 4?"
• "I have a Terraform configuration that deploys ACRE — what needs to change for AMR?"
• "Review my azurerm_redis_enterprise_cluster Terraform module and give me a migration checklist."

Interactive Cache Migration

• "Help me migrate my ACRE caches to AMR."
• "Discover all Redis Enterprise caches in my subscription and tell me which ones are still on ACRE."
• "Migrate my geo-replicated ACRE caches to AMR step by step."
• "I have ACRE caches with Private Link — walk me through the migration."
• "Which of my caches are eligible for in-place migration vs. create-new-and-swap?"

Generic Migration Guide

• "What is the recommended step-by-step process to migrate from ACRE to AMR?"
• "Explain the difference between in-place migration and create-new-and-swap for geo-replicated caches."
• "What are the breaking changes between ACRE and AMR that I should know about?"
• "What happens to my Private Endpoints and DNS zones after migration?"
• "Is there any downtime during in-place migration? Can I roll back?"

Skill Structure

acre-to-amr-migration-skill/
├── SKILL.md                          # Core: scope, mode detection, behavior rules, navigation index
├── README.md                         # This file
├── LICENSE                           # MIT license
├── TODO.md                           # Roadmap items
├── scripts/
│   ├── Poll-MigrationStatus.ps1      # Reusable polling script for migration/creation status (PowerShell)
│   └── poll-migration-status.sh      # Reusable polling script for migration/creation status (Bash)
└── references/
    ├── breaking-changes.md           # Property changes, DNS updates, API versions, PE migration strategies
    ├── script-analysis.md            # Detection patterns, companion files, ACRE indicators, validation
    ├── sku-resolution.md             # listSkusForScaling procedure + fallback mapping table + SKU families
    ├── checklists.md                 # Per-script checklists (ARM, Bicep, CLI, PowerShell)
    ├── examples/                     # Before/after code examples (split by type)
    │   ├── README.md                 # Routing index
    │   ├── arm.md                    # ARM template examples
    │   ├── bicep.md                  # Bicep template examples
    │   ├── cli.md                    # Azure CLI examples
    │   ├── powershell.md             # Azure PowerShell examples
    │   └── connection-strings.md     # Application connection string examples
    ├── migration-guide.md            # Generic migration guide (overview, flowchart, Path A/B summaries)
    ├── interactive-migration.md      # Interactive migration (discovery + in-place + geo-replicated)
    └── troubleshooting.md            # Troubleshooting & FAQ

Per-Mode Reference Loading

Each mode only needs a subset of reference files, keeping agent context lean:

Mode	Files Needed
Automation Script Update	SKILL.md → SCRIPT-ANALYSIS → SKU-RESOLUTION → CHECKLISTS → BREAKING-CHANGES → examples/{type}.md (load only the matching type) or terraform.md for Terraform configs
Interactive Cache Migration	SKILL.md → INTERACTIVE-MIGRATION → SKU-RESOLUTION → Poll-MigrationStatus.ps1 (PowerShell) or poll-migration-status.sh (Bash)
Generic Migration Guide	SKILL.md → MIGRATION-GUIDE → BREAKING-CHANGES

External Resources

This skill leverages:

• Microsoft Learn MCP Server: https://learn.microsoft.com/api/mcp for up-to-date Azure documentation
• SKU Resolution Data: references/sku-resolution.md for ACRE to AMR SKU mapping and fallback table
• Azure CLI Reference: For az redisenterprise and az rest commands used in migration

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
4. Update SKILL.md when new migration patterns emerge

License

MIT