Agent skill · Microsoft (Azure)

Azure Deploy skill for Claude Code, Codex and Cursor

Runs the deployment of an app already prepared for Azure and checks the result.

Officialname: azure-deploy★ 1.6k (repo)pushed 2026-10-23MITSKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

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.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Azure Deploy

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add microsoft/azure-skills --skill azure-deploy

This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (azure, azure-kusto-graph-skills, azure-local-skills, foundry-iq-skills...), or copy only this skill into ~/.claude/skills. docs

/plugin marketplace add microsoft/azure-skills
/plugin install <plugin>@azure-skills

# or only this skill:
npx skills add microsoft/azure-skills --skill azure-deploy -a claude-code

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/microsoft/azure-skills.git /tmp/azure-deploy-src
cp -r /tmp/azure-deploy-src/.github/plugins/azure-skills/skills/azure-deploy ./azure-deploy
zip -r azure-deploy.zip azure-deploy

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add microsoft/azure-skills --skill azure-deploy -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install microsoft/azure-skills azure-deploy

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add microsoft/azure-skills --skill azure-deploy -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/microsoft/azure-skills.git --path .github/plugins/azure-skills/skills/azure-deploy

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add microsoft/azure-skills --skill azure-deploy -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add microsoft/azure-skills --skill azure-deploy -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

Bundles 4 PowerShell/shell scripts the agent can run, so it needs PowerShell and shell on the machine. In the Claude apps, code execution must be on.

What's in the SKILL.md

6 sections

Triggers
Rules
Steps
SDK Quick References
MCP Tools
References

Bundled files

references/auth-best-practices.md
references/global-rules.md
references/live-role-verification.md
references/pre-deploy-checklist.md
references/recipes/README.md
references/recipes/azcli/README.md
references/recipes/azcli/errors.md
references/recipes/azcli/verify.md
references/recipes/azd/README.md
references/recipes/azd/ef-migrations.md
references/recipes/azd/errors.md
references/recipes/azd/functions-deploy.md
references/recipes/azd/post-deployment.md
references/recipes/azd/scripts/apply-migrations.ps1
references/recipes/azd/scripts/apply-migrations.sh
references/recipes/azd/scripts/grant-and-migrate.ps1
references/recipes/azd/scripts/grant-and-migrate.sh
references/recipes/azd/sql-entra-auth.md
references/recipes/azd/sql-managed-identity.md
references/recipes/azd/verify.md
+ 20 more

Loaded only when the instructions point to them.

Facts

Skill name: azure-deploy
Publisher: Microsoft (Azure) (official)
Repo: microsoft/azure-skills
License: MIT
Version: 1.2.2
SKILL.md size: 719 words, 89 lines
Bundled files: 40, 4 scripts (PowerShell, shell), 32 docs
Repo stars: 1.6k (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Azure MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from microsoft/azure-skills

Azure Diagnostics: Troubleshoots production problems on Azure using Monitor, AppLens and resource health.
Azure Prepare (azd): Generates azure.yaml, Bicep or Terraform and Dockerfiles so a project can deploy with azd.

Related cloud & devops skills

Deploy to Vercel · Vercel
GitHub: Fix CI · OpenAI
gcloud CLI · Google
Cloudflare Platform · Cloudflare
Next.js on Cloudflare · Cloudflare
Workers Best Practices · Cloudflare
Wrangler CLI · Cloudflare
New Terraform Provider · HashiCorp

FAQ

What does the azure-deploy skill do?+

Runs the deployment of an app already prepared for Azure and checks the result. In its own SKILL.md, Microsoft (Azure) describes it as: "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."

How do I install the azure-deploy skill?+

Run npx skills add microsoft/azure-skills --skill azure-deploy and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/azure-deploy/SKILL.md; in Codex and Cursor in .agents/skills/azure-deploy/.

Does Azure Deploy work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Azure Deploy?+

Microsoft (Azure), the company or project behind it, in the microsoft/azure-skills repo on GitHub, last pushed 2026-10-23. License: MIT.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers