bicep-diagrams

Bicep Diagram Generator

Generates architecture diagrams directly from Azure Bicep files. Bicep is a domain-specific language (DSL) for deploying Azure resources declaratively.

When to Use

Activate this skill when:

• User has Bicep files (.bicep) and wants to visualize the infrastructure
• User asks to "diagram my Bicep" or "visualize this Bicep infrastructure"
• User mentions Bicep or Azure Bicep
• User wants to see the architecture of their Bicep-deployed resources

How It Works

This skill generates Bicep-specific diagrams by parsing Bicep code and calling the Eraser API directly:

1. Parse Bicep Files: Identify resource declarations, modules, parameters, and outputs
2. Extract Relationships: Map dependencies, resource references, and module hierarchies
3. Generate Eraser DSL: Create Eraser DSL code from Bicep resources
4. Call Eraser API: Use /api/render/elements with diagramType: "cloud-architecture-diagram"

Instructions

When the user provides Bicep code:

1. Parse the Bicep

   • Identify all resource declarations (Microsoft.Compute/virtualMachines, etc.)
   • Extract module declarations and their configurations
   • Note param and output definitions
   • Identify var variables and their usage

2. Map Relationships

   • Track resource dependencies (e.g., dependsOn or implicit dependencies)
   • Group resources by type (compute, networking, storage, etc.)
   • Identify VNets as containers for subnets and resources
   • Note Network Security Groups, Key Vaults, and other security resources

3. Generate Eraser DSL Convert Bicep resources to Eraser DSL:

   • CRITICAL: Label Formatting Rules
     • Labels MUST be on a single line - NEVER use newlines inside label attributes
     • Keep labels simple and readable - prefer separate labels over concatenating too much metadata
     • Format DSL with proper line breaks (one node/group per line, but labels stay on single lines)
     • If including metadata like CIDR blocks or VM sizes, include them in the same quoted label string: [label: "VNet 10.0.0.0/16"]