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.