CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

terraform-starter

Scaffold Terraform 1.9+ infrastructure with provider configuration (AWS/GCP/Azure), modular structure, remote state, variables, outputs, workspaces, and common resource patterns.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./infrastructure/terraform-starter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

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

A highly actionable, code-dense skill body with excellent executable scaffolding and conventions, weakened by an unvalidated destructive workflow (apply/destroy presented as a command menu) and a monolithic structure that inlines full module implementations rather than splitting them into reference files.

Suggestions

Add an explicit ordered workflow with a validation checkpoint, e.g., "init → fmt → validate → plan (review output before proceeding) → apply", especially around destructive apply/destroy operations.

Move the full VPC/RDS/S3 module implementations to a `references/` directory (e.g., `references/modules.md`) and keep only the scaffold script, structure, and one or two key patterns in SKILL.md.

Declare all variables used by the root module and child modules (vpc_cidr, db_instance_class, db_name, db_username, db_password) so the examples are fully self-consistent, and include the compute module pattern wired into main.tf.

DimensionReasoningScore

Conciseness

The body is almost entirely executable material — scaffold commands, HCL blocks, and a command reference — with no concept explanations Claude already knows (no "Terraform is a tool..." padding). It falls short of anchor 5 because ~300 lines of full module implementations (VPC with route tables, RDS, S3) and the structure tree duplicating the scaffold commands could be trimmed or moved out of SKILL.md.

4 / 5

Actionability

The scaffold script, complete HCL patterns, and the `terraform -chdir=infra ...` commands are copy-paste ready and cover the common cases. Minor gaps keep it below anchor 5: `main.tf` and the database module reference `var.vpc_cidr`, `var.db_instance_class`, `var.db_name`, `var.db_username`, and `var.db_password`, which are not declared in the shown `variables.tf`, and no compute module code is provided despite being wired into the root module.

4 / 5

Workflow Clarity

"Common Commands" lists init, fmt, validate, plan, apply in a sensible implicit order, but it reads as a command menu rather than a sequenced workflow, and there is no validation checkpoint such as "review the plan output before apply" for what are destructive operations (apply/destroy). Per the judging guidelines, missing validation steps in destructive workflows cap this dimension at 3.

3 / 5

Progressive Disclosure

Section organization is clear (Scaffold, Structure, Conventions, Patterns, Commands, Integrations), but the file is a monolithic ~400 lines: complete module implementations that clearly belong in reference files are fully inlined, and there are no external references at all. This sits between anchor 2 (content that belongs in separate files is inlined) and anchor 4 (content appropriately split), matching anchor 3's 'content that should be separate is inline' with decent internal structure.

3 / 5

Total

14

/

20

Passed

Description

66%Weight 40%Scale 1-5

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 specific, well-scoped description with good natural trigger terms and a clear 'what'. Its main weakness is the absence of any 'Use when...' trigger clause, which caps completeness and leaves invocation guidance implicit.

Suggestions

Append an explicit trigger clause, e.g., "Use when starting a new Terraform project, scaffolding infrastructure as code, or setting up remote state and environment workspaces."

Add common user phrasings such as "infrastructure as code", "IaC", or "HCL" to broaden trigger term coverage.

Mention the resulting scaffold (runnable repo with modules and environments) to sharpen the 'what' from 'Scaffold' into multiple concrete outcomes.

DimensionReasoningScore

Specificity

The description enumerates concrete deliverables — "provider configuration (AWS/GCP/Azure), modular structure, remote state, variables, outputs, workspaces, and common resource patterns" — which is several specific items with only minor gaps (e.g., the scaffold/init workflow is implied but not named). It falls below anchor 5 because it rests on a single action verb ("Scaffold") plus a component list rather than multiple distinct concrete actions, and above anchor 3 because coverage of the Terraform scaffolding domain is broad, not just 1-2 actions.

4 / 5

Completeness

The "what" is clear and concrete ("Scaffold Terraform 1.9+ infrastructure with provider configuration..."), but there is no "Use when..." clause or equivalent explicit trigger guidance. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3 even with a strong 'what'.

3 / 5

Trigger Term Quality

Strong natural keywords: "Terraform", "infrastructure", "AWS/GCP/Azure", "remote state", "variables, outputs, workspaces" — terms users would genuinely say. It sits below anchor 5 because common variations like "infrastructure as code", "IaC", "HCL", or ".tf" are missing, and above anchor 3 because the included terms go well beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

Naming "Terraform" with provider specifics carves a clear niche distinct from generic infra or config-management skills. It is not a 5 because the description doesn't disambiguate from closely related skills (e.g., a Terraform review/migration skill or other cloud-provisioning skills) — minor overlap risk remains.

4 / 5

Total

15

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

achreftlili/deep-dev-skills

Path

infrastructure/terraform-starter/SKILL.md

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.