Apex Terraform Test

What it does

When your agent uses it

• Plan-mode unit tests
• Apply-mode integration tests
• Test troubleshooting
• Architecture decisions

Example prompts

• “create terraform test”
• “write tftest”
• “.tftest.hcl”
• “/apex-terraform-test”

Requirements

• Compatibility (from SKILL.md): Requires Terraform >= 1.6 (test blocks), >= 1.7 (mock providers), >= 1.9 (parallel execution)

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

1. 1Naming: *_unit_test.tftest.hcl / *_integration_test.tftest.hcl
2. 2Plan mode first: Use command = plan for fast, cost-free validation
3. 3Clear error messages: Describe what went wrong and expected state
4. 4Test isolation: Independent run blocks where possible
5. 5Variable coverage: Test multiple combinations for all code paths
6. 6Mock for speed: Use mock providers in CI without Azure access
7. 7Negative testing: Use expect_failures for validation rule coverage
8. 8Sequential only when needed: Only chain run blocks via run. when required

What it can do on your machine

Read from SKILL.md and the folder at commit b8e5908. 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

  Shell commands in SKILL.md call:

  • terraform

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

• Network

  Links to these hosts (documentation or services it may open):

  • developer.hashicorp.com

  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.

• Compatibility

  Requires Terraform >= 1.6 (test blocks), >= 1.7 (mock providers), >= 1.9 (parallel execution)

  From compatibility in the SKILL.md frontmatter.

Context cost

Apex Terraform Test loads about 1.6k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 484 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~105

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.1k

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

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 jonathan-vella/apex at commit b8e5908, republished under its MIT licence (© jonathan-vella). 484 words, ~1,637 tokens.

name

apex-terraform-test

description

**WORKFLOW SKILL** — Write and run Terraform tests (.tftest.hcl). WHEN: "create terraform test", "write tftest", ".tftest.hcl", "mock provider", "test module", "test assertion". USE FOR: test files, run blocks, assertions, mock providers, plan-mode unit tests, apply-mode integration tests, test troubleshooting. DO NOT USE FOR: Bicep code, architecture decisions, deployment (use apex-azure-deploy).

compatibility

Requires Terraform >= 1.6 (test blocks), >= 1.7 (mock providers), >= 1.9 (parallel execution)

user-invocable

true

disable-model-invocation

false

argument-hint

test path and plan or mock mode

my-module/
├── main.tf
├── variables.tf
├── outputs.tf
└── tests/
    ├── defaults_unit_test.tftest.hcl        # Plan mode (fast)
    ├── validation_unit_test.tftest.hcl      # Plan mode (fast)
    └── full_stack_integration_test.tftest.hcl  # Apply mode (creates resources)

assert {
  condition     = <boolean expression>
  error_message = "Human-readable failure description"
}

terraform test                              # All tests
terraform test -filter=tests/defaults_unit_test.tftest.hcl # Specific file
terraform test -verbose                     # Detailed output
terraform test -test-directory=integration-tests # Custom test directory

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

Files

SKILL.md and 4 other files (references) in .github/skills/apex-terraform-test of jonathan-vella/apex.

• SKILL.md
• references/mock-providers.md
• references/test-examples.md
• references/test-execution.md
• references/test-patterns.md

Open the folder on GitHubat commit b8e5908