terraform-search-import

Discover existing cloud resources using Terraform Search queries and bulk import them into Terraform management. Use when bringing unmanaged infrastructure under Terraform control, auditing cloud resources, or migrating to IaC.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/terraform/skills/terraform-search-import/SKILL.md

Quality

Content

75%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.

The body is highly actionable with executable examples and a clear, validated workflow that appropriately externalizes the manual-import fallback. The main weakness is conciseness, where repeated basic examples and a re-shown provider block add token cost without new information.

Suggestions

Consolidate the recurring basic 'list "aws_instance" "all"' example so it appears once (e.g., under Basic Discovery) and is referenced elsewhere, reducing redundant HCL blocks.

Add an explicit validate→fix→retry loop for the batch import (e.g., 'if terraform plan fails on generated config, remove computed attributes and re-plan before apply') to raise workflow clarity.

Trim the re-shown provider block in the Complete Example to just the query and command sequence, since the provider config is already demonstrated in Prerequisites and Query File Structure.

Dimension	Reasoning	Score
Conciseness	Mostly efficient, but the basic 'list "aws_instance" "all"' example recurs across the Query File Structure and Basic Discovery sections, and the provider block is re-shown in the Complete Example, indicating tighten-able redundancy rather than the lean 4-5 levels.	3 / 5
Actionability	Provides copy-paste-ready HCL and bash covering common cases (basic, filtered, multi-region, parameterized discovery) plus a full end-to-end workflow, matching the 'fully executable, common cases covered' anchor.	5 / 5
Workflow Clarity	A clear decision tree and sequenced workflow are present with verification steps (terraform state list, terraform show -json) and a troubleshooting table, satisfying the batch-operation validation requirement; not a 5 because there is no explicit validate→fix→retry feedback loop stated as a loop.	4 / 5
Progressive Disclosure	The manual-import fallback is properly externalized to references/MANUAL-IMPORT.md and clearly linked one level deep, with scripts kept separate and the body well-sectioned; not a 5 because the SKILL.md itself is a detailed guide rather than a lean overview pointing to deeper materials.	4 / 5
	Total	16 / 20 Passed

Description

82%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.

The description is strong, clearly answering both what the skill does and when to use it with concrete, natural trigger phrases and a distinct niche. The only minor weakness is specificity, where it names two actions rather than enumerating several granular capabilities.

Dimension	Reasoning	Score
Specificity	Names the domain and two concrete actions — 'Discover existing cloud resources' and 'bulk import them into Terraform management' — but does not enumerate several distinct actions, matching the '1-2 concrete actions' anchor rather than the 'several specific actions' anchor above.	3 / 5
Completeness	Explicitly states what it does (discover via Terraform Search queries, bulk import into Terraform management) and when to use it with concrete trigger phrases, matching the anchor for clearly answering both what and when.	5 / 5
Trigger Term Quality	Includes natural user phrases such as 'bringing unmanaged infrastructure under Terraform control', 'auditing cloud resources', and 'migrating to IaC', giving good keyword coverage with only minor synonyms missing; not a 5 because coverage is not exhaustive.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Terraform Search queries + bulk import) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: hashicorp/agent-skills
Path: plugins/terraform/skills/terraform-search-import/SKILL.md
Commit: 3268468

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.