---

name: converting-bicep-to-avm description: Converts raw Bicep resource definitions to Azure Verified Modules (AVM). Use when user asks to convert to AVM, replace resources with modules, use verified modules, or modernize bicep templates.

Converting Bicep to AVM Skill

Before Converting

Call Bicep:list_avm_metadata MCP tool to get available Azure Verified Modules and their versions.

Conversion Workflow

1. Identify resources — List all resource declarations in the template
2. Find AVM matches — Call Bicep:list_avm_metadata, match by resource type
3. Map properties — Translate resource properties to AVM parameters
4. Generate module — Create module declaration with registry reference
5. Update references — Replace resource.property with module.outputs.property
6. Validate — Lint the Bicep template and afterwards run bicep build to verify syntax
7. Fix errors — If build fails, review error, fix mapping, return to step 6

AVM Module Reference Format

Copymodule <symbolicName> 'br/public:avm/res/<provider>/<resource>:<version>' = {
  name: '<deploymentName>'
  params: {
    name: <resourceName>
    location: <location>
    // AVM-specific parameters
  }
}

Common Resource Type Mappings

⚠️ Always call Bicep:list_avm_metadata for current modules and versions. This table is for reference only and may be outdated.

Property Mapping Guidelines

Common Patterns

AVM Adds Common Features

AVM modules often include built-in support for:

• Diagnostic settings (diagnosticSettings)
• Role assignments (roleAssignments)
• Private endpoints (privateEndpoints)
• Locks (lock)
• Tags (tags)

Handling No AVM Match

If no AVM module exists:

1. Keep the raw resource definition
2. Add comment: // TODO: No AVM module available for <resourceType>
3. Check for pattern modules (avm/ptn/*) as alternatives

Output Transformation

Before:

Copyoutput keyVaultUri string = keyVault.properties.vaultUri

After:

Copyoutput keyVaultUri string = keyVaultModule.outputs.uri

Note: AVM output names differ from raw properties — check module documentation.

Conversion Report Format

Copy## AVM Conversion: [filename]

### Converted
| Resource | AVM Module | Version |
|----------|------------|---------|
| keyVault | avm/res/key-vault/vault | 0.11.0 |

### Not Converted
| Resource | Reason |
|----------|--------|
| customResource | No AVM module available |

### Manual Review Required
- [ ] Verify parameter mappings
- [ ] Update output references
- [ ] Test deployment