Azure Deployment Environments

Organization

MicrosoftDocs

azure-deployment-environments

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).

Overview

Publisher	MicrosoftDocs
Repository	`Agent-Skills`
Skill name	`azure-deployment-environments`
Stars	778
Forks	126
Bundled files	Instructions only
License	CC-BY-4.0
Links	Skill source Repository Homepage

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by MicrosoftDocs on GitHub. Read the source before you install it.

Installation

Install the Azure Deployment Environments AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-deployment-environments
Enable the skill in any chat where you want it available.

Store

Installed

Skills

Add skills

Import one or more skills from a public GitHub folder or a local .skill or .zip archive, or SKILL.md file.

From GitHub URLFrom .skill, .zip, or SKILL.md

GitHub repo or folder

https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-deployment-environments

Points to a single skill folder, or any folder that contains multiple skills. Public repos only.

CancelContinue

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/MicrosoftDocs/Agent-Skills.git /tmp/Agent-Skills
mkdir -p .claude/skills
cp -r /tmp/Agent-Skills/skills/azure-deployment-environments .claude/skills/azure-deployment-environments

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Azure Deployment Environments in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Azure Deployment Environments on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Azure Deployment Environments is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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

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

Frequently asked questions

What does the Azure Deployment Environments AI skill do?

Why use Azure Deployment Environments on TypingMind?

Because you install it once and use it with any model. Azure Deployment Environments is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Azure Deployment Environments in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-deployment-environments. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Azure Deployment Environments?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Azure Deployment Environments?

As many as you like. As long as a model supports skills, you can use Azure Deployment Environments with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Azure Deployment Environments AI skill free?

Yes. It is published on GitHub by MicrosoftDocs under the CC-BY-4.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Land And Deploy

garrytan

CommunityPopular

Land and deploy workflow. (gstack)

Clawsweeper

Use for all ClawSweeper work: OpenClaw issue/PR sweep reports, repair jobs, cloud fix PRs, @clawsweeper maintainer mention commands, trusted ClawSweeper-reviewed autofix/automerge, GitHub Actions…

Openclaw Ci Limits

Manage OpenClaw GitHub Actions and Blacksmith CI capacity, runner-registration budgets, fanout caps, main-push single-flight, shard sizing, hosted-runner offload, queue health, and safe…

Openclaw Testing

Choose proportional OpenClaw tests and checks, diagnose failures, and route environment-sensitive or release proof to its owner.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Azure Deployment Environments Skill

How to Use This Skill

Category Index

Troubleshooting

Best Practices

Decision Making

Architecture & Design Patterns

Limits & Quotas

Security

Configuration

Integrations & Coding Patterns

Deployment

Frequently asked questions

Related AI Skills

Set up your own AI workspace now