CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-verified-modules

Azure Verified Modules (AVM) requirements and best practices for developing certified Azure Terraform modules. Use when creating or reviewing Azure modules that need AVM certification.

90

1.24x
Quality

77%

Does it follow best practices?

Impact

91%

1.24x

Average score across 10 eval scenarios

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./terraform/code-generation/skills/azure-verified-modules/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

A dense, highly actionable AVM requirements reference with strong executable HCL examples and a verification checklist, but it is a ~600-line monolith that would benefit from splitting into reference files and from an ordered validation workflow with feedback loops.

Suggestions

Move the per-category requirement details (Variables, Outputs, Code Style, etc.) into separate files under references/ and keep SKILL.md as a concise overview with one-level-deep links, improving both progressive disclosure and conciseness.

Add an ordered module-development workflow with explicit validation checkpoints (e.g., `terraform fmt` -> `tflint` -> `terraform validate` -> fix -> re-run) and a feedback loop, rather than only a static compliance checklist.

Trim the intro sentence, the Summary Statistics section, and the closing footer, which restate information already conveyed by the requirement list, to tighten token efficiency.

DimensionReasoningScore

Conciseness

Per-section density is lean (severity/requirement headers, bullet rules, tight HCL examples), but the intro sentence, the Summary Statistics counts, and the closing footer restate information already conveyed by the requirement list. Not 1 because it avoids explaining concepts Claude already knows and is not padded with generic context; not 3 because not every token earns its place and the ~600-line monolith could be tightened.

2 / 3

Actionability

Provides fully executable HCL examples (required_providers blocks, for_each maps, dynamic blocks, outputs, feature-toggle variables), specific tool lists ('terraform validate/fmt/test', 'terafmt', 'checkov', 'tflint'), and a copy-paste-ready compliance checklist. Not 2 because the examples are real, complete code rather than pseudocode with missing details.

3 / 3

Workflow Clarity

The Compliance Checklist and Testing tool list provide some structure, but there is no ordered module-development workflow with explicit validate→fix→retry checkpoints; per the feedback_loops note, missing feedback loops for batch/destructive Terraform operations caps this at 2. Not 1 because a verification checklist and named validation tools do exist; not 3 because no sequenced workflow with feedback loops is present.

2 / 3

Progressive Disclosure

The body is well-organized (Table of Contents, clear section headers) but is a ~600-line monolith with all per-category requirements inline and no bundle files to split content one level deep. Not 1 because it is well-sectioned with a TOC rather than a disorganized wall and references are not deeply nested; not 3 because content that belongs in separate reference files is entirely inline, and the under-50-lines exception does not apply.

2 / 3

Total

9

/

12

Passed

Description

90%

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

A concise, third-person description that clearly answers both what the skill does and when to use it, with a well-scoped niche that minimizes conflict risk. The only weakness is that capabilities are stated abstractly ('requirements and best practices') rather than as a list of concrete actions.

DimensionReasoningScore

Specificity

Names the domain and actions ('developing certified Azure Terraform modules', 'creating or reviewing Azure modules') but the phrase 'requirements and best practices' is abstract rather than a list of multiple concrete actions. Not 1 because it is far from vague ('Helps with documents'); not 3 because it does not enumerate several specific concrete actions like the score-3 anchor.

2 / 3

Completeness

Explicitly states what ('AVM requirements and best practices for developing certified Azure Terraform modules') and when ('Use when creating or reviewing Azure modules that need AVM certification'), matching the score-3 anchor pattern with an explicit 'Use when' trigger. Not 2 because the 'when' is explicit, not merely implied.

3 / 3

Trigger Term Quality

Covers the niche's natural vocabulary with 'Azure Verified Modules (AVM)', 'Azure Terraform modules', and 'AVM certification' — terms a user would actually say when needing this skill. Not 2 because it provides multiple natural phrasings plus the acronym rather than a single bare keyword.

3 / 3

Distinctiveness Conflict Risk

The 'AVM certification' / 'Azure Verified Modules' niche is tightly scoped with distinct triggers, making accidental triggering for unrelated skills unlikely. Not 2 because it is far more specific than a generic 'Works with document files' phrasing.

3 / 3

Total

11

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (614 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
hashicorp/agent-skills
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.