azure-upgrade Skill for Claude: Upgrade Azure Plans, SKUs and SDKs

Has Claude assess and carry out Azure upgrades such as Functions Consumption to Flex Consumption and old Java SDKs to the modern SDK.

Installs: 470.2K; on skills.sh
Stars: 1.6K; on GitHub
Files: 49; besides SKILL.md
Updated: Oct 2026; last repo commit

azure-upgrade runs an assessment first, then an automated upgrade, for three scenarios it handles itself: Functions Consumption to Flex Consumption (Linux and Windows) and legacy Azure Java SDK to the modern one. It lists two more, Azure Cache for Redis and Redis Enterprise to Azure Managed Redis, but only routes those to dedicated skills (amr-migration-skill, acre-to-amr-migration-skill) kept in separate AzureManagedRedis repos. Its Redis reference says it does not ship the migration logic, so install the matching skill yourself. It follows seven steps: identify, assess, pre-migrate, upgrade, validate, ask, hand off.

It makes changes in your Azure account, so its rules matter. Claude must confirm the target plan or SKU, announce new resource names before creating them, ask before any destructive step, and never delete or stop the original app without your say-so. For Windows Functions apps it treats the source as read-only and asks before each change. It uses Azure MCP tools, so use the plugin from the install box.

Good for

Azure Functions owners moving from Consumption to Flex Consumption
Teams planning an Azure Cache for Redis move to Azure Managed Redis, who need the right dedicated migration skill picked
Java teams replacing the legacy com.microsoft.azure SDKs

Install azure-upgrade

Claude Code

Copy this prompt.

Install the azure-upgrade skill in Claude Code. Run this command:

/plugin install azure@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires An Azure account, Node.js 18+, Azure CLI signed in with az login.

The README installs these skills as one plugin that also wires in the Azure MCP Server, so there is no per-skill install. Run it inside Claude Code. Install the Azure Developer CLI and sign in with azd auth login too if you plan to deploy. azure-upgrade calls Azure MCP tools for best practices and docs, which the plugin sets up.

From the project README. Source.

What's in the skill

When it loads

Assess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies in source code. WHEN: upgrade Consumption to Flex Consumption, upgrade Azure Functions plan, change hosting plan, function app SKU, migrate App Service to Container Apps, modernize legacy Azure Java SDKs (com.microsoft.azure to com.azure), migrate Azure Cache for Redis (ACR/ACRE) to Azure Managed Redis (AMR).

Sections in SKILL.md

Triggers
Rules
Upgrade Scenarios
MCP Tools
Steps
References
Next

Key facts

Author: Microsoft
Repository: microsoft/azure-skills, folder skills/azure-upgrade
Installs on skills.sh: 470,219 as of 2026-11-02
GitHub stars: 1,609 for the whole microsoft/azure-skills repo, 2026-11-02
License: MIT
Last repo commit: 2026-10-30
What is inside: 49 bundled files besides SKILL.md: scenario guides, templates and one Python script (upgrade_bom.py)
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass

What it includes

Finds the source and target plan or SKU
Claude asks you to confirm both.
Read · 1. Identify
Checks the app's readiness for the upgrade
Loads the matching scenario guide first. An assessment always comes before any change.
Network · 2. Assess
Collects settings, identities and configuration
Copies what the new resource will need.
Network · 3. Pre-migrate
Creates new resources, moves settings and deploys code
Runs scripts that are meant to be safe to repeat and resume.
Try: “Upgrade my function app from Consumption to Flex Consumption.”
Runs code · 4. Upgrade
Checks target state, endpoints, triggers and monitoring
Records a check as deferred rather than relaxing security to pass it.
Network · 5. Validate
Offers performance checks, IaC updates and source cleanup
Cleanup is offered only when the scenario confirms production cutover.
Read · 6. Ask
Passes to azure-validate or azure-deploy
Deeper validation or CI/CD setup in sibling skills.
Read · 7. Hand off
Updates legacy com.microsoft.azure code to com.azure
Follows plan, progress and summary templates; includes a BOM upgrade script.
Runs code · Java SDK migration

From the official docs

Permissions

High risk

Claude can create new Azure resources, move settings and code, and offer to clean up the old app. Run it on a test app first and approve each step by hand.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It creates and changes live Azure resources
Upgrades create a new app or cache and move settings and code. Try a test app first and read each proposed resource name and change. github.com
Deleting the original needs your explicit yes
SKILL.md bars deleting or stopping the source app without confirmation. Keep the original until the new one is validated. github.com
Cutover can affect production traffic
Validation and cutover touch triggers and endpoints. Plan a window and check the validation results before you switch. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. The assessment step only reads, so ask Claude to stop after assessment if you only want a report.
Talks to	Azure Resource Manager calls made by the Azure CLI and Azure MCP tools. Your AI provider receives what Claude reads from your Azure account
Sign-in and keys	Uses your existing Azure CLI sign-in (az login). SKILL.md sets up no separate key.
Scopes	Creates Azure resources and moves settings and code under your Azure sign-in Runs migration automation scripts, including a Python BOM upgrade script for Java Writes progress files such as upgrade-status.md to your project

Questions

How do I install azure-upgrade?

Use the install box at the top of this page. It installs the Azure plugin for Claude Code, which brings in the Azure MCP tools this skill calls. Python 3.10 or newer is listed in the skill's compatibility field.

What can azure-upgrade upgrade?

Two paths run inside the skill: Functions Consumption to Flex Consumption (Linux and Windows) and legacy Java SDK (com.microsoft.azure) to com.azure. Azure Cache for Redis and Redis Enterprise to Azure Managed Redis are listed too, but the skill only points you to separate dedicated skills in the AzureManagedRedis GitHub org. For anything else it researches the path with Azure docs tools.

Will it delete my original app?

Not without your permission. SKILL.md says never to delete or stop the original app without explicit confirmation, and to ask before any destructive action. For Windows Functions apps, each change to the source app needs your approval.

What is the difference between azure-upgrade and azure-validate or azure-deploy?

azure-upgrade assesses and moves an existing workload. After a validated upgrade it hands off to azure-validate for deeper checks, or to azure-deploy to set up CI/CD for the new app. Both come with the Azure plugin.

Is azure-upgrade safe?

Use care. It can create resources and change settings in your Azure account, and it runs automation scripts. It has approval gates and a rule to assess first. Try it on a test app before production.

Information

updated Nov 2, 2026

Repository: microsoft/azure-skills
Folder: skills/azure-upgrade

microsoft/azure-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

microsoft/azure-skills README · github.com
azure-upgrade SKILL.md · github.com
azure-upgrade Redis to AMR reference · github.com