Official agent skill

Review Tests Helpers

by hashicorp in hashicorp/terraform-provider-aws

Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exportstest.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version…

OfficialMPL-2.0Auto-check passedTesting & QA

Install Review Tests Helpers

skills CLI
$ npx skills add hashicorp/terraform-provider-aws --skill review-tests-helpers -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashicorp/terraform-provider-aws review-tests-helpers --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/review-tests-helpers .claude/skills/review-tests-helpers && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
review-tests-helpers
GitHub stars
11k
Token cost
~994 tokens
SKILL.md length
321 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MPL-2.0

At a glance

Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exportstest.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version…

  • Reviewing a PR that changes check helpers
  • SKILL.md covers Exists / Destroy helpers, exports_test.go, Data source tests and List resource tests, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Data-source/list/unit tests in internal/service//test.go

What it does

Review Tests Helpers is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization. Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exportstest.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version floor), and unit tests. Use when reviewing a PR that changes check helpers or data-source/list/unit tests in internal/service//test.go.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Infrastructure as code, Unit testing and Integration testing. It works with Terraform and Amazon Web Services. The repository describes itself as: The AWS Provider enables Terraform to manage AWS resources. The licence is MPL-2.0.

When your agent uses it

  • Reviewing a PR that changes check helpers
  • Data-source/list/unit tests in internal/service//test.go

Example prompts

  • “/review-tests-helpers”

What it can do on your machine

Read from SKILL.md and the folder at commit f4a1d21. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are go).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Review Tests Helpers loads about 994 tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 321 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~994

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashicorp/terraform-provider-aws at commit f4a1d21, republished under its MPL-2.0 licence (© hashicorp). 321 words, ~994 tokens.

Download SKILL.mdSave it as .claude/skills/review-tests-helpers/SKILL.md (or your agent's skills folder).
name
review-tests-helpers
description
Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exports_test.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version floor), and unit tests. Use when reviewing a PR that changes check helpers or data-source/list/unit tests in internal/service/**/*_test.go.
<!-- Copyright IBM Corp. 2014, 2026 -->
<!-- SPDX-License-Identifier: MPL-2.0 -->

Review: Test Helpers, Data Source Tests, List Resource Tests, Unit Tests

Assume the @maintainer persona. Scope: Exists/Destroy helpers, data source tests, list resource tests, unit tests. See review-tests for per-resource basics. Loaded from review-pr.

Exists / Destroy helpers

testAccCheck<Resource>Exists should:

  • Look up the resource state with s.RootModule().Resources[name].
  • Verify rs.Primary.ID != "".
  • Use acctest.ProviderMeta(ctx, t).<Service>Client(ctx) for the client — never construct a fresh client.
  • Call the exported finder tf<svc>.Find<Name>ByID(ctx, conn, ...).

testAccCheck<Resource>Destroy should:

  • Skip rows where rs.Type != "aws_<svc>_<thing>".
  • Treat retry.NotFound(err) as success (return nil).
  • Use errs.IsA[*awstypes.<NotFoundException>] rather than type assertions if it inspects errors directly.

Wrap real failures with create.Error(names.<Service>, create.ErrActionCheckingExistence|ErrActionCheckingDestroyed, tf<svc>.ResName<Name>, id, err) rather than fmt.Errorf / errors.New.

exports_test.go

Test files reach into the package via a sibling exports_test.go:

go
package <svc>

var (
    Resource<Name> = new<Name>Resource   // Framework
    // or: Resource<Name> = resource<Name> // SDKv2
    Find<Name>ByID = find<Name>ByID
)

Flag PRs that export production identifiers (capitalize the real find<Name>ByID) instead of using exports_test.go, or reach into the package via build tags or internal/ traversal hacks. The package is imported in tests as tf<svc> "github.com/hashicorp/terraform-provider-aws/internal/service/<svc>".

Data source tests

Data source tests follow the resource conventions with these differences:

  • Reference dataSourceName := "data.aws_<svc>_<thing>.test".
  • Prefer resource.TestCheckResourceAttrPair(dataSourceName, attr, resourceName, attr) over hard-coded values when the data source mirrors a resource.
  • No _disappears test.
  • A CheckDestroy is still required when the test creates a backing resource.

List resource tests

List resources require three scenarios for parity:

  • _List_basic — basic listing.
  • _List_includeResource — with include_resource = true and full attribute checks.
  • _List_regionOverride — region override; requires acctest.PreCheckMultipleRegion(t, 2).

List resource tests use static testdata, not inline configs:

go
ConfigDirectory: config.StaticDirectory("testdata/<Resource>/list_<scenario>/"),
ConfigVariables: config.Variables{ acctest.CtRName: config.StringVariable(rName), ... },

A separate Step with Query: true exercises the list operation. Identity assertions use tfstatecheck.Identity() / identity.GetIdentity(resourceName) and the tfquerycheck.* helpers under internal/acctest/querycheck.

List resource tests also require a Terraform version floor (currently 1.14):

go
TerraformVersionChecks: []tfversion.TerraformVersionCheck{
    tfversion.SkipBelow(tfversion.Version1_14_0),
},

Unit tests

Unit tests are for logic that doesn't touch AWS — parsers, custom flatteners/expanders, ID composition, validators. They:

  • Run in parallel (t.Parallel() at top and inside subtests).
  • Are table-driven with t.Run(tc.TestName, ...).
  • Must not call acctest.Context, acctest.PreCheck, or instantiate an AWS client.

Flag unit tests added for trivial pass-through flatteners/expanders — they're noise. Flag acceptance-style tests mis-named without the TestAcc prefix.

© hashicorp, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/review-tests-helpers of hashicorp/terraform-provider-aws.

Open the folder on GitHubat commit f4a1d21

Compare with similar skills

Review Tests Helpers next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Review Tests Helpers compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Review Tests Helpers this skillhashicorp/terraform-provider-aws11k—~994Automated safety check: PassMPL-2.0
Avm Tf TestingAzure/terraform-azurerm-avm-ptn-alz135—~1.8kAutomated safety check: PassMIT
New Event Sourceaws/aws-lambda-dotnet1.7k—~3kAutomated safety check: PassApache-2.0
Datadog Terraform Provider Test RunnerDataDog/terraform-provider-datadog468—~949Automated safety check: PassMPL-2.0
Fix Broken Datadog Provider TestsDataDog/terraform-provider-datadog468—~2.4kAutomated safety check: NotesMPL-2.0
Provider Verificationmondoohq/mql412—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • Avm Tf Testing

    Azure/terraform-azurerm-avm-ptn-alz

    Official

    A skill your agent uses for AVM Terraform validation, provider-mocked unit tests, real-Azure integration tests, E2E example tests, PowerShell hooks, OIDC, policy checks, and Avm.Authoring CI behavior.

    135 GitHub stars~1.8k tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • New Event Source

    aws/aws-lambda-dotnet

    Official

    Add a new AWS event source attribute (e.g., Kinesis, Kafka, MQ) to the Lambda .NET Annotations framework, including the attribute class, source generator integration, CloudFormation writer, unit…

    1.7k GitHub stars~3k tokensUpdated today
    Testing & QAAuto-check passed
  • Datadog Terraform Provider Test Runner

    DataDog/terraform-provider-datadog

    Official

    Runs Datadog Terraform provider acceptance tests in none, true or false record modes, then saves trimmed output and pass, fail and skip counts to a timestamped file.

    468 GitHub stars~949 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Fix Broken Datadog Provider Tests

    DataDog/terraform-provider-datadog

    Official

    Runs an end-to-end workflow to diagnose, reproduce, fix and validate a failing integration test in the Datadog Terraform provider, ending with a draft PR.

    468 GitHub stars~2.4k tokensUpdated yesterday
    Testing & QAAuto-check: notes
  • Verify mql provider resource/field changes against real cloud infrastructure.

    412 GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

More from hashicorp/terraform-provider-aws

All 17 skills in this repo
  • Review Docs

    hashicorp/terraform-provider-aws

    Official

    Review a Terraform AWS Provider PR's end-user documentation (website/docs//.markdown): whether docs are needed, description openings, argument/attribute style, section structure, tags wording, code…

    11k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Review Helpers

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider helper code: finders, status functions, waiters, sweepers, data sources, and list resources.

    11k GitHub stars~978 tokensUpdated today
    Auto-check passed
  • Review Identity

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider Resource Identity: the identity-strategy annotations (@ArnIdentity, @SingletonIdentity, @IdentityAttribute), multi-attribute @ImportIDHandler parsers, and region…

    11k GitHub stars~692 tokensUpdated today
    Auto-check passed
  • Review Lifecycle

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider resource lifecycle: CRUD step order, smerr/smarterr error handling, and AutoFlex model-to-SDK conversion.

    11k GitHub stars~990 tokensUpdated today
    Auto-check passed
  • Review Schema

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider Plugin Framework schema shape: model structs, Required/Optional/Computed combinations, plan modifiers (no ForceNew), nested-block custom types, validators, sensitive…

    11k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Review Tags

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider tagging: the tags/tagsall schema attributes, the @Tags(identifierAttribute=...) annotation, and wiring input.Tags = getTagsIn(ctx) after flex.Expand.

    11k GitHub stars~462 tokensUpdated today
    Auto-check passed

Questions about Review Tests Helpers

What does Review Tests Helpers do?

Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exportstest.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version…. Review Tests Helpers is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization.Error wrapping, data source tests, list resource tests (querycheck + Terraform version floor), and unit tests.

When should I use Review Tests Helpers?

Review Tests Helpers fits situations like: reviewing a PR that changes check helpers; data-source/list/unit tests in internal/service//test.go.

How do I install Review Tests Helpers in Claude Code?

Run `npx skills add hashicorp/terraform-provider-aws --skill review-tests-helpers -a claude-code`. Or copy the skill folder (.agents/skills/review-tests-helpers in hashicorp/terraform-provider-aws) into .claude/skills/review-tests-helpers in your project. Claude Code loads it when a task matches its description.

How do I install Review Tests Helpers in Codex?

Run `npx skills add hashicorp/terraform-provider-aws --skill review-tests-helpers -a codex`. Or copy the skill folder (.agents/skills/review-tests-helpers in hashicorp/terraform-provider-aws) into .agents/skills/review-tests-helpers in your project. Codex loads it when a task matches its description.

Can I use Review Tests Helpers in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashicorp/terraform-provider-aws --skill review-tests-helpers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/review-tests-helpers, .gemini/skills/review-tests-helpers, .github/skills/review-tests-helpers and .opencode/skills/review-tests-helpers in your project.

What does Review Tests Helpers need to run?

SKILL.md names no scripts, command-line tools or credentials: Review Tests Helpers is instructions for the agent only.

Does Review Tests Helpers access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Review Tests Helpers safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Review Tests Helpers use?

Review Tests Helpers is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Review Tests Helpers use?

About 994 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Review Tests Helpers?

Skills that share tags, products or a category with Review Tests Helpers: Avm Tf Testing (Azure/terraform-azurerm-avm-ptn-alz, 135 stars), New Event Source (aws/aws-lambda-dotnet, 1.7k stars), Datadog Terraform Provider Test Runner (DataDog/terraform-provider-datadog, 468 stars) and Fix Broken Datadog Provider Tests (DataDog/terraform-provider-datadog, 468 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Review Tests Helpers?

hashicorp (a GitHub organization, an official publisher) maintains it in hashicorp/terraform-provider-aws, which has 11,113 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 10, 2026.

Source: hashicorp/terraform-provider-aws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.