iac-bicep

Validate Bicep templates and preview Azure deployments before pushing changes.

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/eric-sabe/engsys --skill iac-bicep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iac-bicep
Source: https://github.com/eric-sabe/engsys/tree/main/stacks/iac/bicep/skills/iac-bicep
Command: npx skills add https://github.com/eric-sabe/engsys --skill iac-bicep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the common, costly pain points of Azure Bicep infrastructure-as-code workflows, including failed deployments, configuration drift, and hours of wasted debugging from uncaught template errors and Azure-specific gotchas.

Core Features & Use Cases

  • Standardized Project Layout: Enforces a consistent, recreatable Bicep file structure (main.bicep orchestrator, reusable modules, per-environment parameter files) to avoid snowflake infrastructure.
  • Pre-Deploy Validation Workflow: Mandates the bicep build → az deployment validate → what-if preview flow to catch errors locally before triggering long CI runs.
  • Hard-Won Azure Gotchas Library: Documents expensive, rarely-documented Bicep/ARM quirks (globally-unique name collisions, ACR SKU limits, KQL interpolation issues, incorrect metric names) to avoid trial-and-error in production.
  • Use Case: For example, when deploying a PostgreSQL Flexible Server module, this skill prevents the common misconfiguration of enabling PgBouncer on a Burstable SKU that would cause a failed production deployment.

Quick Start

Use the iac-bicep skill to validate your Bicep template and run a what-if deployment preview before pushing changes to your Azure infrastructure.

Frequently Asked Questions about iac-bicep

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

FAQPage Schema
How do I prevent Azure Bicep deployment failures before running CI pipelines?

To prevent Azure Bicep deployment failures, enforce a pre-deploy validation workflow that runs bicep build, az deployment validate, and a what-if preview locally to catch template errors and configuration drift before triggering long CI runs.

Why does my Bicep PostgreSQL Flexible Server deployment fail when enabling PgBouncer?

Your Bicep PostgreSQL Flexible Server deployment fails because enabling PgBouncer on a Burstable SKU is an unsupported misconfiguration. Applying documented Azure resource configuration best practices prevents these costly trial-and-error deployment blockers.

How do I structure Bicep modules to avoid configuration drift across environments?

To avoid configuration drift across environments, structure Bicep modules using a main.bicep orchestrator with reusable modules and per-environment parameter files, ensuring a consistent and recreatable project layout that eliminates snowflake infrastructure.

What Azure ARM deployment gotchas cause long debugging sessions in Bicep?

Azure ARM deployment gotchas that cause long debugging include globally-unique name collisions, ACR SKU limits, KQL interpolation issues, and incorrect metric names. Documenting these rarely-known quirks eliminates trial-and-error debugging.

Can I validate Bicep templates and manage secrets with Azure Key Vault?

Yes, you can validate Bicep templates and manage secrets using Azure Key Vault. This workflow satisfies requirements for pre-deploy validation gates and secure secret management, ensuring template configurations are correct and secure before deployment.

What is the best way to troubleshoot failed ARM sub-deployments in Bicep?

The best way to troubleshoot failed ARM sub-deployments in Bicep is to run a what-if deployment preview and apply a library of hard-won Azure gotchas, addressing configuration issues like metric name mismatches before they reach production.