Catalog
github/update-avm-modules-in-bicep

github

update-avm-modules-in-bicep

Update Azure Verified Modules (AVM) to latest versions in Bicep files.

global
New~550
v1.0Saved Jun 26, 2026

Update Azure Verified Modules in Bicep Files

Update Bicep file ${file} to use latest Azure Verified Module (AVM) versions. Limit progress updates to non-breaking changes. Don't output information other than the final output table and summary.

Process

  1. Scan: Extract AVM modules and current versions from ${file}
  2. Identify: List all unique AVM modules used by matching avm/res/{service}/{resource} using #search tool
  3. Check: Use #fetch tool to get latest version of each AVM module from MCR: https://mcr.microsoft.com/v2/bicep/avm/res/{service}/{resource}/tags/list
  4. Compare: Parse semantic versions to identify AVM modules needing update
  5. Review: For breaking changes, use #fetch tool to get docs from: https://github.com/Azure/bicep-registry-modules/tree/main/avm/res/{service}/{resource}
  6. Update: Apply version updates and parameter changes using #editFiles tool
  7. Validate: Run bicep lint and bicep build using #runCommands tool to ensure compliance.
  8. Output: Summarize changes in a table format with summary of updates below.

Tool Usage

Always use tools #search, #searchResults,#fetch, #editFiles, #runCommands, #todos if available. Avoid writing code to perform tasks.

Breaking Change Policy

⚠️ PAUSE for approval if updates involve:

  • Incompatible parameter changes
  • Security/compliance modifications
  • Behavioral changes

Output Format

Only display results in table with icons:

| Module | Current | Latest | Status | Action | Docs |
|--------|---------|--------|--------|--------|------|
| avm/res/compute/vm | 0.1.0 | 0.2.0 | 🔄 | Updated | [📖](link) |
| avm/res/storage/account | 0.3.0 | 0.3.0 | ✅ | Current | [📖](link) |

### Summary of Updates

Describe updates made, any manual reviews needed or issues encountered.

Icons

  • 🔄 Updated
  • ✅ Current
  • ⚠️ Manual review required
  • ❌ Failed
  • 📖 Documentation

Requirements

  • Use MCR tags API only for version discovery
  • Parse JSON tags array and sort by semantic versioning
  • Maintain Bicep file validity and linting compliance
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

77/100

Grade

B

Good

Safety

82

Quality

73

Clarity

78

Completeness

68

Summary

A skill for updating Azure Verified Modules (AVM) in Bicep infrastructure-as-code files to their latest versions. The skill scans Bicep files for AVM module references, queries the Microsoft Container Registry (MCR) API for available versions, identifies breaking changes, and applies safe updates while validating the resulting code with bicep build/lint commands.

Detected Capabilities

file readfile writehttp requestsemantic version parsingjson parsingshell command executionbicep build validation

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

update azure modulesavm bicep versionslatest module versionsbicep dependency updateinfrastructure as code modernization

Risk Signals

INFO

HTTP requests to mcr.microsoft.com and github.com for module metadata

Process section, steps 3 and 5
INFO

Shell execution of bicep lint and bicep build commands

Process section, step 7
INFO

File modification via #editFiles tool on Bicep source files

Process section, step 6
INFO

Use of ${file} template variable for Bicep file targeting

Header and context

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.commcr.microsoft.com

Use Cases

  • Automate AVM module version updates in Bicep projects
  • Keep Azure infrastructure code current with latest module releases
  • Identify and safely apply non-breaking AVM module updates
  • Review breaking changes before applying major AVM module updates
  • Validate Bicep file compliance after updating AVM modules

Quality Notes

  • Strength: Clear 8-step process with well-defined phase boundaries (Scan→Identify→Check→Compare→Review→Update→Validate→Output)
  • Strength: Breaking change policy explicitly pauses execution for manual review of incompatible parameter changes, security modifications, or behavioral changes
  • Strength: Documented tool usage requirements — delegates file operations to tools rather than using raw shell commands
  • Strength: Specific output format with table structure and icon legend makes results machine-readable
  • Strength: Requirements section defines version discovery constraints (MCR API, semantic versioning, linting compliance)
  • Weakness: Minimal error handling guidance — no documented fallback behavior if MCR API is unavailable, module not found, or bicep build fails
  • Weakness: No handling documented for partial updates — what happens if some modules update successfully but others fail?
  • Weakness: Limited scope documentation on which Bicep file types/structures are supported (single module file, monorepo patterns, nested imports)
  • Weakness: No mention of rollback strategy or version pinning guidance if an update introduces issues after validation
  • Weakness: Context about PAUSE behavior is vague — no guidance on how user approval is obtained or processed
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Add github/update-avm-modules-in-bicep to your library

Command Palette

Search for a command to run...