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

module <symbolicName> 'br/public:avm/res/<provider>/<resource>:<version>' = {
  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 resource definition
2. Add comment: // TODO: No AVM module available for <resourceType>
3. Check for pattern modules (avm/ptn/*) as alternatives

Output Transformation

Before:

output keyVaultUri string = keyVault.properties.vaultUri

After:

output keyVaultUri string = keyVaultModule.outputs.uri

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

Conversion Report Format

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