--- title: "azure-deploy skill: run azd up and terraform apply with an agent" canonical_url: https://cookiesforai.app/skills/microsoft/azure-deploy last_updated: 2026-10-02T01:58:30+02:00 type: skill summary: "azure-deploy is Microsoft's agent skill for deploying an already prepared and validated app to Azure with azd, Bicep or Terraform, with error recovery, role checks and verified https endpoints at the end." install: "npx skills add microsoft/azure-skills --skill azure-deploy" related: - "https://cookiesforai.app/skills/vercel-labs/deploy-to-vercel" - "https://cookiesforai.app/skills/vercel-labs/vercel-cli-with-tokens" - "https://cookiesforai.app/skills/vercel-labs/vercel-optimize" - "https://cookiesforai.app/skills/cloudflare/workers-best-practices" - "https://cookiesforai.app/skills/microsoft/azure-diagnostics" --- # Azure deploy azure-deploy is Microsoft's agent skill for deploying an already prepared and validated app to Azure with azd, Bicep or Terraform, with error recovery, role checks and verified https endpoints at the end. | Fact | Value | |---|---| | Publisher | Microsoft (official, own GitHub account) | | Source | https://github.com/microsoft/azure-skills/tree/HEAD/skills/azure-deploy | | License | MIT | | Repository stars | 1,522 on 2026-10-02 | | Skill name | azure-deploy | | Version | 1.2.1 (from its SKILL.md, https://github.com/microsoft/azure-skills/blob/HEAD/skills/azure-deploy/SKILL.md, read 2026-10-02) | | Category | Cloud and deployment | | Skill last changed | 2026-08-10 | | Page updated | 2026-10-02 | | Facts checked | 2026-10-02 | ## Install Install this skill with the skills CLI: ``` npx skills add microsoft/azure-skills --skill azure-deploy ``` Or, in Claude Code, install Microsoft's Azure plugin from Anthropic's official marketplace: ``` /plugin install azure@claude-plugins-official ``` Or, in Gemini CLI, install the Azure extension: ``` gemini extensions install https://github.com/microsoft/azure-skills ``` Or, in GitHub Copilot CLI, add Microsoft's marketplace: ``` /plugin marketplace add microsoft/azure-skills ``` Then install the Azure plugin in Copilot CLI: ``` /plugin install azure@azure-skills ``` The plugin and extension routes install all of Microsoft's Azure skills together with the Azure MCP Server and Foundry MCP. The skills CLI line installs only this skill's instructions, not the MCP servers it calls. In Codex, run codex plugin marketplace add microsoft/azure-skills, then install azure from /plugins. ## Ask your coding agent A skill can include scripts that run on your computer, so read its source first: https://github.com/microsoft/azure-skills/tree/HEAD/skills/azure-deploy ```text Install the agent skill azure-deploy from github.com/microsoft/azure-skills. ``` ## What it does azure-deploy is an agent skill from Microsoft that runs the deployment step for an app that is already prepared for Azure. It owns the commands that change cloud resources: azd up, azd deploy, terraform apply and az deployment. It refuses to start unless .azure/deployment-plan.md exists with the status Validated and a filled-in validation proof, and it forbids the agent from setting that status itself. The azure-deploy workflow has ten steps. The agent reads the plan, works through a pre-deploy checklist, loads the recipe for the plan's deployment type, and for Container Apps with a registry checks that the AcrPull role has propagated. It then deploys, applies post-deploy steps such as SQL managed identity and EF migrations, handles errors from the recipe's error guide, and confirms the endpoints respond. After deployment the skill has the agent query Azure to confirm the assigned roles are correct and sufficient, then report every endpoint as a full https link. Destructive actions need the user's confirmation. Reference files cover troubleshooting, azd and Azure Identity in Python, .NET, TypeScript and Java. ## When to use it - Your app is prepared for Azure and you want to run azd up or azd deploy. - You want terraform apply or a Bicep deployment run with checks before and after. - You are pushing an update to an app that already runs on Azure. - A Container Apps deployment fails because the image cannot be pulled from the registry. ## When to pick something else - Creating a new app or writing its infrastructure: the skill sends that to azure-prepare, then azure-validate, both in the same repository. ## What it needs - An Azure subscription, Azure CLI signed in with az login, and Azure Developer CLI signed in with azd auth login - A .azure/deployment-plan.md marked Validated by the azure-validate skill ## Which agents it works in Microsoft documents it for GitHub Copilot (VS Code, Copilot CLI, IntelliJ IDEA), Claude Code, Codex, Cursor, Gemini CLI, OpenCode. The open skills CLI also installs it into 78 agents (listed with the CLI on 2026-10-01). The skill calls tools from the Azure MCP Server (names starting mcp_azure_mcp). The plugin routes install that server; with the skills CLI alone the agent falls back to the Azure CLI commands the skill also lists. ## License MIT. ## Related ### Related skills for cloud and deployment - [Deploy to Vercel](https://cookiesforai.app/skills/vercel-labs/deploy-to-vercel): Deploy to Vercel is Vercel's agent skill for getting a project live: the agent checks how your project is set up, picks a deploy method and returns a preview link unless you ask for production. - [Vercel CLI with Tokens](https://cookiesforai.app/skills/vercel-labs/vercel-cli-with-tokens): Vercel CLI with Tokens is Vercel's agent skill for running the Vercel CLI with an access token instead of vercel login: deploys, environment variables, logs and domains. - [Vercel Optimize](https://cookiesforai.app/skills/vercel-labs/vercel-optimize): Vercel Optimize is Vercel's agent skill that audits a deployed project from its production metrics and returns ranked, verified fixes to cut cost and speed up slow routes. - [Workers best practices](https://cookiesforai.app/skills/cloudflare/workers-best-practices): workers-best-practices is Cloudflare's agent skill for writing, reviewing and configuring production Cloudflare Workers, built around a table of anti-patterns to flag and current docs over memorized APIs. ### More from Microsoft - [Azure diagnostics](https://cookiesforai.app/skills/microsoft/azure-diagnostics): azure-diagnostics is Microsoft's agent skill for debugging Azure production problems with AppLens, Azure Monitor and resource health, with guides for App Service, Functions, Container Apps, AKS, VMs and messaging.