CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-bicep-patterns

**UTILITY SKILL** — Reusable Azure Bicep patterns: hub-spoke, private endpoints, diagnostics, AVM composition. WHEN: "hub-spoke Bicep", "private endpoint module", "diagnostic settings", "AVM Bicep composition". USE FOR: Bicep template design, hub-spoke networking, private endpoint patterns, AVM modules. DO NOT USE FOR: Terraform code (use terraform-patterns), architecture decisions (use azure-adr), troubleshooting, diagram generation (use drawio).

75

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the key criteria. It provides specific capabilities, natural trigger terms, explicit when/when-not guidance, and clear boundaries against related skills. The DO NOT USE FOR clause is a particularly strong addition that helps Claude disambiguate between similar infrastructure-related skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and patterns: hub-spoke, private endpoints, diagnostics, AVM composition, Bicep template design. These are concrete, identifiable capabilities rather than vague abstractions.

3 / 3

Completeness

Clearly answers both 'what' (reusable Azure Bicep patterns for hub-spoke, private endpoints, diagnostics, AVM composition) and 'when' (explicit WHEN clause with trigger phrases, USE FOR clause, and even a DO NOT USE FOR clause that helps with disambiguation).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'hub-spoke Bicep', 'private endpoint module', 'diagnostic settings', 'AVM Bicep composition', 'Bicep template design'. These are terms practitioners naturally use when working with Azure infrastructure-as-code.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche (Azure Bicep patterns specifically) and explicit DO NOT USE FOR boundaries that distinguish it from terraform-patterns, azure-adr, and drawio skills. This significantly reduces conflict risk.

3 / 3

Total

12

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured utility skill that provides actionable Bicep patterns with clear workflow steps and validation checkpoints. Its progressive disclosure is excellent, with a concise overview pointing to well-organized reference files. The main weakness is moderate redundancy across sections (AVM pinning, What-If guidance repeated in Steps, Rules, and Gotchas), which could be consolidated to save tokens.

Suggestions

Consolidate AVM version pinning guidance — it appears substantively in Steps (step 4), Rules, and Gotchas; keep the authoritative statement in one place and cross-reference from the others.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and avoids explaining basic concepts Claude already knows, but there is some redundancy — the AVM version pinning rule is restated in Steps, Rules, and Gotchas sections, and the What-If guidance appears in multiple places. The Gotchas section, while valuable, is lengthy and could be tightened.

2 / 3

Actionability

The skill provides concrete, executable guidance: specific CLI commands (`az deployment group what-if`, `bicep build`, `bicep lint`, `npm run validate:iac-security-baseline`), exact MCR URLs for version discovery, specific Bicep code snippets (metric-alert criteria, scope splitting), and precise module interface contracts with required inputs/outputs.

3 / 3

Workflow Clarity

The Steps section provides a clear 7-step sequence with explicit validation checkpoints (step 6: what-if before deploy, step 7: build + lint + security baseline validation). The workflow includes a feedback loop implicit in the what-if review step and covers the full lifecycle from pattern identification through validation.

3 / 3

Progressive Disclosure

Excellent progressive disclosure structure: a Quick Reference table maps patterns to specific reference files, the body stays concise with overview-level content, and detailed patterns are delegated to clearly-signaled one-level-deep references (6 reference files). The Reference Index table provides a complete navigation aid. Cross-skill references to azure-defaults and iac-policy-compliance are clearly marked as canonical sources.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.