Back to Skills

azure-deploy

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push

181stars119forksUpdated 4/8/2026

Security Assessment

Critical Risk(25/100)

Detected risks:

Destructive Operations([references/global-rules.md] rm -rf)
Remote Code Execution([references/sdk/azd-deployment.md] curl -fsSL https://aka.ms/install-azd.sh | bash)
Sensitive File Access([references/recipes/azd/errors.md] .Env, [references/auth-best-practices.md] .env, [references/recipes/azd/ef-migrations.md] .Env)
Security Score25/100

About azure-deploy

The azure-deploy skill is designed to streamline the process of deploying already-prepared applications to Azure. It provides an automated, error-resilient deployment pipeline for applications that have already been configured and validated using other related Azure skills, namely azure-prepare and azure-validate. This skill primarily addresses the problem of ensuring that deployment processes are consistent, repeatable, and error-free, thus enabling smooth transitions to production environments without needing manual intervention or reconfiguration for each deployment cycle.

With the azure-deploy skill, users can execute key Azure deployment commands such as azd up, azd deploy, terraform apply, and az deployment with built-in error recovery. This ensures that deployments are executed with high reliability and that any issues encountered during the deployment process are automatically addressed. The skill is specifically designed to work with applications that are already prepared and validated, meaning it does not handle the creation of new applications or infrastructure setup, which should be handled by the azure-prepare skill.

This skill is ideal for developers and DevOps engineers working with pre-configured Azure applications that require deployment or updates to existing environments. Use cases include pushing updates to production, deploying applications with pre-configured API Management (APIM) infrastructure, or managing deployments in an existing cloud infrastructure. It is not intended for new application creation or initial infrastructure setup, which is outside its scope. Users should ensure that the necessary prerequisites, such as validated deployment plans, are met before invoking the skill for deployment execution.

FAQ

What should I do if the plan status is not 'Validated'?

If the plan status is not 'Validated', you must run the azure-validate skill before using azure-deploy. Skipping validation can cause deployment failures.

Can I use azure-deploy to create a new application?

No, the azure-deploy skill is designed only for executing deployments of already-prepared applications. For creating new applications, use the azure-prepare skill instead.

What if I need to modify infrastructure before deployment?

The azure-deploy skill is focused on deployment execution. To modify infrastructure, you should use the azure-prepare skill first, which handles the creation and configuration of infrastructure.

Does azure-deploy support rollback in case of deployment failure?

While azure-deploy includes built-in error recovery mechanisms, it does not perform a full rollback. Any necessary manual intervention may be required in the event of a failed deployment.

Is this skill compatible with all types of Azure applications?

This skill works with applications that have been prepared and validated with the azure-prepare and azure-validate skills. It is compatible with applications that already include pre-configured infrastructure such as API Management.

All Files

37 files
SKILL.md6.4 KB
View
references/pre-deploy-checklist.md8.6 KB
View
references/recipes/azcli/verify.md2.1 KB
View
references/recipes/azd/functions-deploy.md3.4 KB
View
references/recipes/azd/verify.md4.8 KB
View
references/recipes/terraform/errors.md0.5 KB
View
references/live-role-verification.md3.8 KB
View
references/recipes/azcli/errors.md0.5 KB
View
references/recipes/azd/errors.md13.4 KB
View
references/recipes/azd/sql-managed-identity.md7.3 KB
View
references/recipes/bicep/verify.md0.8 KB
View
references/recipes/cicd/examples/azdo-multistage.yml0.8 KB
View
references/auth-best-practices.md6.0 KB
View
references/recipes/README.md0.4 KB
View
references/recipes/azd/README.md3.7 KB
View
references/recipes/azd/post-deployment.md4.2 KB
View
references/recipes/bicep/README.md2.4 KB
View
references/recipes/cicd/errors.md0.5 KB
View
references/recipes/cicd/examples/github-bicep.yml0.7 KB
View
references/global-rules.md1.2 KB
View
references/recipes/azcli/README.md1.7 KB
View
references/recipes/azd/ef-migrations.md7.8 KB
View
references/recipes/azd/sql-entra-auth.md2.1 KB
View
references/recipes/bicep/errors.md0.5 KB
View
references/recipes/cicd/examples/azdo-azd.yml0.5 KB
View
references/recipes/cicd/verify.md0.8 KB
View
references/recipes/cicd/README.md1.2 KB
View
references/recipes/cicd/examples/github-azd.yml0.8 KB
View
references/region-availability.md2.9 KB
View
references/sdk/azure-identity-py.md1.1 KB
View
references/recipes/terraform/README.md2.2 KB
View
references/sdk/azd-deployment.md0.8 KB
View
references/sdk/azure-identity-ts.md1.1 KB
View
references/recipes/terraform/verify.md0.8 KB
View
references/sdk/azure-identity-java.md1.2 KB
View
references/sdk/azure-identity-dotnet.md0.9 KB
View
references/troubleshooting.md8.0 KB
View

Install azure-deploy

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill