azure-deployment-environments — Claude Code skill: setup guide
azure-deployment-environments guides ADE workflows including environment.yaml schemas, dev center setup, custom container images, and CI/CD pipelines.
CC-BY-4.0 172 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a claude-codeWhat azure-deployment-environments does
This skill equips coding agents with structured reference material for Azure Deployment Environments (ADE). It indexes guidance across troubleshooting, architectural resilience, catalog layouts, RBAC assignment, and quota management. The agent uses line-targeted reads and remote documentation fetching to solve infrastructure tasks.
Inside, topics span environment.yaml configuration, project-level environment types, ADE CLI variables, and container image debugging. It also covers CI/CD integration with GitHub Actions and Azure Pipelines. It explicitly excludes Azure DevTest Labs, Dev Box, and ARM-specific tasks, which rely on companion skills.
Network access is mandatory during execution. The skill retrieves reference Markdown using mcp_microsoftdocs:microsoft_docs_fetch or the fetch_webpage fallback. Without network connectivity, detailed documentation cannot be pulled.
What it helps with
- write valid environment.yaml definitions for ADE templates
- diagnose failed custom image deployments from container logs
- configure managed identities and RBAC roles for a dev center
- automate ADE environment provisioning inside GitHub Actions
Example prompts for the agent
- Help me write an environment.yaml schema for an Azure Deployment Environments catalog item
- Diagnose why this custom image failed during ADE environment provisioning
- How do I set up project-level environment types and auto-deletion in ADE?
How to install azure-deployment-environments
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a claude-code2Manually: put the files in place
~/.claude/skills/azure-deployment-environments/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-deployment-environments/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a codex2Manually: put the files in place
.agents/skills/azure-deployment-environments/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a cursor2Manually: put the files in place
.cursor/skills/azure-deployment-environments/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-deployment-environments2Manually: put the files in place
.github/skills/azure-deployment-environments/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-deployment-environmentsManually: put the files in place
.devin/skills/azure-deployment-environments/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-deployment-environments
How to install azure-deployment-environments in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a claude-code in your terminal.
What does azure-deployment-environments do?
It provides your agent with architecture patterns, troubleshooting steps, and reference documentation for Azure Deployment Environments.
What tools are required for this skill to fetch documentation?
It requires network access and prefers the mcp_microsoftdocs:microsoft_docs_fetch tool, falling back to fetch_webpage when MCP is absent.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-deployment-environments description: Expert knowledge for Azure Deployment Environments development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when defining environment.yaml, configuring dev centers/projects, using ADE/Dev CLI, custom images, or CI/CD deployments, and other Azure Deployment Environments related development tasks. Not for Azure DevTest Labs (use azure-devtest-labs), Azure Dev Box (use azure-dev-box), Azure Managed Applications (use azure-managed-applications), Azure Resource Manager (use azure-resource-manager). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-09-20" generator: "docs2skills/1.0.0" --- # Azure Deployment Environments Skill This skill provides expert guidance for Azure Deployment Environments. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown. ## Category Index | Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L37-L41 | Diagnosing and resolving custom image deployment failures in Azure Deployment Environments, including common error patterns, logs to inspect, and remediation steps. | | Best Practices | L42-L46 | Guidance on organizing and structuring Azure Deployment Environments catalogs, including repo layout, template grouping, naming, and governance for scalable, maintainable catalogs. | | Decision Making | L47-L51 | Guidance on planning, executing, and managing the retirement or replacement of Azure Deployment Environments, including migration and decommissioning considerations. | | Architecture & Design Patterns | L52-L56 | Guidance on designing resilient, scalable Azure Deployment Environments architectures, including fault tolerance, high availability, redundancy, and best practices for robust environment design. | | Limits & Quotas | L57-L61 | Requesting and managing quota increases for Azure Deployment Environments resource limits, including how to handle capacity constraints and raise support requests. | | Security | L62-L69 | RBAC and identity setup for Deployment Environments: planning and assigning roles, configuring managed identities, and authenticating to the REST APIs. | | Configuration | L70-L82 | Defining environment.yaml, configuring dev centers/projects, catalogs, environment types, CLI/ARM setup, auto-deletion, and ADE CLI env vars for Azure Deployment Environments. | | Integrations & Coding Patterns | L83-L89 | Using Azure Developer CLI and ADE CLI to create environments, build custom container images, and manage custom image workflows for Azure Deployment Environments | | Deployment | L90-L93 | Using Azure Deployment Environments with CI/CD tools (Azure Pipelines, GitHub Actions) to automate environment creation, updates, and deployments from templates. | ### Troubleshooting | Topic | URL | |-------|-----| | Diagnose custom image deployment failures in Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors | ### Best Practices | Topic | URL | |-------|-----| | Structure Azure Deployment Environments catalogs efficiently | https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure | ### Decision Making | Topic | URL | |-------|-----| | Plan retirement and replacement for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/deployment-environments-retirement-guide | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design resilient Azure Deployment Environments architectures | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments | ### Limits & Quotas | Topic | URL | |-------|-----| | Request quota increases for ADE resource limits | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase | ### Security | Topic | URL | |-------|-----| | Plan Azure RBAC roles for Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control | | Authenticate to Azure Deployment Environments REST APIs | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate | | Configure managed identity for Azure Deployment Environments dev center | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity | | Assign RBAC roles for Azure Deployment Environments access | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access | ### Configuration | Topic | URL | |-------|-----| | Define Azure Deployment Environments with environment.yaml schema | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-environment-yaml | | Configure Git-based catalogs for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-catalog | | Configure dev center environment types in Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-devcenter-environment-types | | Configure project-level environment types in Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-project-environment-types | | Install and use the devcenter Azure CLI extension | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-install-devcenter-cli-extension | | Configure automatic deletion for ADE environments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-schedule-environment-deletion | | Configure dev centers and catalogs for Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-and-configure-devcenter | | Provision dev centers and projects with ARM templates | https://learn.microsoft.com/en-us/azure/deployment-environments/quickstart-create-dev-center-project-azure-resource-manager | | Reference ADE CLI environment variables for custom images | https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-variables | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Create ADE environments using Azure Developer CLI | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-azure-developer-cli-deployment-environments | | Use custom container images with Azure Deployment Environments | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image | | Use ADE CLI commands for custom image workflows | https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli | ### Deployment | Topic | URL | |-------|-----| | Integrate ADE with Azure Pipelines for CI/CD | https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills