Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-deployment-environments -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/azure-deployment-environments/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-deployment-environments/

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-sre-agent Skill for Azure SRE Agent work: integrations with Azure DevOps, GitHub, Kusto, ServiceNow, PagerDuty, Teams, Azure Monitor, and Application Insights. CX Codex +1 173installs azure-quotas azure-quotas guides AI agents through Azure Storage limits and quota increase requests across portal, CLI, and support channels. CX Codex +1 173installs azure-analysis-services This skill guides Azure Analysis Services work and network troubleshooting. It helps investigate server access, firewall, DNS, VNet, and client connection issues. CX Codex +1 173installs azure-dev-box azure-dev-box is a Claude Code skill that indexes Microsoft Dev Box documentation. The agent finds a section on connectivity, images, quotas or access and fetches the matching Microsoft Learn page. CX Codex +1 172installs azure-update-manager This skill guides Azure Update Manager setup, troubleshooting, VM patch planning, and automation through SDKs or REST APIs. CX Codex +1 172installs azure-cyclecloud Agent reference for Azure CycleCloud: cluster templates, Slurm setup, HB/HC tuning, security, and automation through the API, CLI or Python SDK. CX Codex +1 172installs azure-virtual-wan Reference skill for Azure Virtual WAN architecture and routing. Guides configuration of virtual hubs, P2S VPN, BGP, and SD-WAN integrations. CX Codex +1 172installs azure-data-manager-for-agri Provides technical guidance for Azure Data Manager for Agriculture, covering IoT ingestion, Sentinel Hub imagery, quotas, and Event Grid setup. CX Codex +1 171installs

Project sponsors

Companies that keep this analytics open