About azure-env-builder
Azure Environment Builder is a skill for planning and scaffolding enterprise Azure environments with Bicep. It gathers requirements, uses Azure Verified Modules and service schemas, and covers deployment pipelines and low-cost operations demos.
Key features
- 01Select from architecture patterns
- 02Use Azure Verified Modules
- 03Generate Bicep environment scaffolds
- 04Link service configuration and Managed ID RBAC
- 05Create CI/CD pipeline templates
- 06Plan low-cost operations demos
Use cases
- 01Design a Hub-Spoke or web-and-database environment
- 02Deploy apps to App Service, AKS, or Container Apps
- 03Create an Azure AI Foundry workload environment
- 04Build a low-cost operations demo with alerts and logs
MCP support
The workflow requires MCP tools to retrieve current Azure Verified Module metadata, Bicep best practices, and resource schemas before generating Bicep. It also uses Microsoft Docs search for relevant documentation.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ aktsmm/ agent-skills --skill azure-env-builderAfter installing, type/azure-env-builderin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
LICENSE.txtreferences/app-deploy-patterns.mdarchitecture-patterns.mdavm-modules.mdenvironment-template.mdhearing-checklist.mdlow-cost-ops-demo.mdresource-patterns.mdreview-checklist.mdservice-config-templates.mdvm-app-scripts.mdreferences/cicd-templates/azure-pipelines.ymlgithub-actions.ymlREADME.mdscripts/preview_cli.ps1scaffold_environment.ps1validate_bicep.ps1Details
From the project READMEAzure Environment Builder
Enterprise Azure environment builder skill.
When to Use
- Azure, Bicep, infrastructure, deploy app
- Building enterprise Azure environments
- Deploying apps to App Service, AKS, or Container Apps
- Designing Hub-Spoke, AKS, or AI Foundry architectures
- Creating low-cost Azure operations demos with alerts, logs, portal steps, and minimal always-on resources
When NOT to Use
- 使い捨ての検証 lab を作って機能・制約・route 挙動を試し、cleanup まで回したいとき(対象外)
- 本番障害を read-only で切り分けたいとき(対象外)
Features
| Category | Capabilities |
|---|---|
| Architecture | Hub-Spoke, Web+DB, AKS, AI Foundry |
| AVM Modules | 200+ Azure Verified Modules |
| VM Init | Squid, Nginx, Docker, IIS setup |
| Config Linking | SQL/Storage/Redis, Managed ID RBAC |
| CI/CD | GitHub Actions / Azure Pipelines |
| Ops Demo | Low-cost app, alert, log, and control-plane failure patterns |
Workflow
- Interview - Gather requirements + select architecture pattern
- MCP Tools - Fetch latest AVM/schema info
- Scaffold - Generate environment folder via
scripts/scaffold_environment.ps1 - Implement - Write Bicep with AVM modules + VM init
- CI/CD - Generate pipeline templates
- Deploy - what-if → execute
Required: MCP Tools
Run before generating Bicep code:
mcp_bicep_experim_get_bicep_best_practices
mcp_bicep_experim_list_avm_metadata
mcp_bicep_experim_get_az_resource_type_schema(azResourceType, apiVersion)
microsoft_docs_search(query: "Private Endpoint Bicep")
Interview Checklist
→ references/hearing-checklist.md
| Item | Details |
|---|---|
| Subscription | ID or az account show |
| Environment | dev / staging / prod |
| Region | japaneast / japanwest |
| Deploy Type | Azure CLI / Bicep |
Architecture Patterns
→ references/architecture-patterns.md
| Pattern | Use Case |
|---|---|
| Hub-Spoke | Large enterprise |
| Web + DB | Standard web applications |
| AKS | Container microservices |
| AI Foundry | AI/ML workloads |
| Proxy VM | Private network egress control |
Commands
# Scaffold environment folder
pwsh scripts/scaffold_environment.ps1 -Environment <env> -Location <region> -DeploymentMode <CLI|Bicep|Both>
# Validate
az deployment group what-if --resource-group <rg> --template-file main.bicep
# Deploy
az deployment group create --resource-group <rg> --template-file main.bicep
Key References
| File | Purpose |
|---|---|
| architecture-patterns.md | Architecture patterns |
| avm-modules.md | AVM module catalog |
| vm-app-scripts.md | VM init scripts |
| app-deploy-patterns.md | App deploy patterns |
| low-cost-ops-demo.md | Low-cost operations demos |
| service-config-templates.md | Service config linking |
| cicd-templates/ | CI/CD templates |
Done Criteria
- Interview checklist completed
- MCP tools fetched latest info
- Bicep files generated
-
az deployment group what-ifsucceeded