azure-env-builder

[Alpha] Experimental Azure environment builder for infrastructure and deployment design. Use when building Azure infrastructure, generating Bicep with AVM modules, deploying apps to App Service/AKS/Container Apps, or designing Hub-Spoke, AKS, and AI Foundry architectures.

11 stars

Best use case

azure-env-builder is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

[Alpha] Experimental Azure environment builder for infrastructure and deployment design. Use when building Azure infrastructure, generating Bicep with AVM modules, deploying apps to App Service/AKS/Container Apps, or designing Hub-Spoke, AKS, and AI Foundry architectures.

Teams using azure-env-builder should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/azure-env-builder/SKILL.md --create-dirs "https://raw.githubusercontent.com/aktsmm/Agent-Skills/main/azure-env-builder/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/azure-env-builder/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How azure-env-builder Compares

Feature / Agentazure-env-builderStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

[Alpha] Experimental Azure environment builder for infrastructure and deployment design. Use when building Azure infrastructure, generating Bicep with AVM modules, deploying apps to App Service/AKS/Container Apps, or designing Hub-Spoke, AKS, and AI Foundry architectures.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Azure 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

## 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   |

## Workflow

1. **Interview** - Gather requirements + select architecture pattern
2. **MCP Tools** - Fetch latest AVM/schema info
3. **Scaffold** - Generate environment folder via `scripts/scaffold_environment.ps1`
4. **Implement** - Write Bicep with AVM modules + VM init
5. **CI/CD** - Generate pipeline templates
6. **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](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](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

```powershell
# Scaffold environment folder
pwsh scripts/scaffold_environment.ps1 -Environment <env> -Location <region>

# 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](references/architecture-patterns.md)       | Architecture patterns  |
| [avm-modules.md](references/avm-modules.md)                           | AVM module catalog     |
| [vm-app-scripts.md](references/vm-app-scripts.md)                     | VM init scripts        |
| [app-deploy-patterns.md](references/app-deploy-patterns.md)           | App deploy patterns    |
| [service-config-templates.md](references/service-config-templates.md) | Service config linking |
| [cicd-templates/](references/cicd-templates/)                         | CI/CD templates        |

## Done Criteria

- [ ] Interview checklist completed
- [ ] MCP tools fetched latest info
- [ ] Bicep files generated
- [ ] `az deployment group what-if` succeeded

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.