azure-prepare

Generates azure.yaml, Bicep or Terraform infrastructure, and Dockerfiles for azd-based Azure deployments.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/merceralex397-collab/alex-stack --skill azure-prepare-merceralex397-collab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-prepare
Source: https://github.com/merceralex397-collab/alex-stack/tree/main/dev/azure-profile/azure-skills-main/azure-skills-main/.github/plugins/azure-skills/skills/azure-prepare
Command: npx skills add https://github.com/merceralex397-collab/alex-stack --skill azure-prepare-merceralex397-collab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Preparing an application for Azure deployment requires writing azure.yaml configuration, infrastructure-as-code templates, and Dockerfiles by hand, which is error-prone and often leads to failed deployments. This Skill produces a validated deployment plan and all required artifacts for the Azure Developer CLI (azd) workflow. ## Core Features & Use Cases - Plan-First Workflow: Creates a mandatory .azure/deployment-plan.md covering requirements, architecture, recipe selection, and quota validation before generating any code. - Artifact Generation: Produces azure.yaml, Bicep or Terraform templates in infra/, and Dockerfiles, with special handling for .NET Aspire, Azure Functions, and Durable Functions projects. - Azure Context & Quota Checks: Confirms subscription and region with the user, verifies region availability, and validates provisioning quotas before execution. - Use Case: You have an existing web app and want to deploy it to Azure Container Apps with azd. The Skill scans the codebase, plans the architecture, generates the infrastructure, and hands off to azure-validate and azure-deploy. ## Quick Start Ask the assistant to prepare your project for Azure deployment with azd, for example: prepare this app for Azure deployment using azd and generate the infrastructure.

Frequently Asked Questions about azure-prepare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare an app for Azure deployment with azd?▼

Use this Skill to analyze your workspace, create a deployment plan, and generate azure.yaml plus Bicep or Terraform infrastructure. After plan approval, it produces all artifacts and hands off to azure-validate before deployment.

Should I use Bicep or Terraform for Azure infrastructure?▼

The Skill defaults to azd with Bicep for new projects, and azd with Terraform when Terraform is requested or .tf files exist. Pure Terraform is reserved for multi-cloud scenarios or complex Terraform workflows incompatible with azd conventions.

Does azd init work with .NET Aspire projects?▼

Yes, Aspire projects must use azd init --from-code with an environment name flag, which auto-detects the AppHost and generates azure.yaml and infrastructure. Manually creating azure.yaml for Aspire projects causes deployment failures.

When should I not use azure-prepare?▼

Do not use it for non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migrations from AWS or GCP (use azure-cloud-migrate). It also never executes deployments directly.

Why does deployment fail without a deployment plan file?▼

The .azure/deployment-plan.md file is the source of truth consumed by the azure-validate and azure-deploy skills. Without it written to the workspace root, validation and deployment steps fail by design.