
Run Acceptance Tests
Run and debug Terraform provider acceptance tests (`TestAcc*`) with the right `go test` flags and `TF_ACC` environment so infra code actually proves against real APIs.
Install
npx skills add https://github.com/hashicorp/agent-skills --skill run-acceptance-testsWhat is this skill?
- Runs focussed tests with `go test -run=TestAccFeatureHappyPath` and `TF_ACC=1`
- Default non-verbose output with escalation path: `-count=1`, `-v`, `TF_LOG=debug`, `TF_ACC_WORKING_DIR_PERSIST=1`
- Surfaces missing provider env vars and suggests secure setup when tests fail for credentials
- Explains false-negative risk and how to "flip" a passing `TestAcc` to validate test rigor
- IBM HashiCorp MPL-2.0 procedural guide versioned 0.0.1 in skill metadata
Adoption & trust: 1.5k installs on skills.sh; 654 GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
Recommended Skills
Agent Browservercel-labs/open-agents
Tddmattpocock/skills
Use My Browserxixu-me/skills
Test Driven Developmentobra/superpowers
Verification Before Completionobra/superpowers
Webapp Testinganthropics/skills
Journey fit
Common Questions / FAQ
Is Run Acceptance Tests safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Run Acceptance Tests
An acceptance test is a Go test function with the prefix `TestAcc`. To run a focussed acceptance test named `TestAccFeatureHappyPath`: 1. Run `go test -run=TestAccFeatureHappyPath` with the following environment variables: - `TF_ACC=1` Default to non-verbose test output. 1. The acceptance tests may require additional environment variables for specific providers. If the test output indicates missing environment variables, then suggest how to set up these environment variables securely. To diagnose a failing acceptance test, use these options, in order. These options are cumulative: each option includes all the options above it. 1. Run the test again. Use the `-count=1` option to ensure that `go test` does not use a cached result. 1. Offer verbose `go test` output. Use the `-v` option. 1. Offer debug-level logging. Enable debug-level logging with the environment variable `TF_LOG=debug`. 1. Offer to persist the acceptance test's Terraform workspace. Enable persistance with the environment variable `TF_ACC_WORKING_DIR_PERSIST=1`. A passing acceptance test may be a false negative. To "flip" a passing acceptance test named `TestAccFeatureHappyPath`: 1. Edit the value of one of the TestCheckFuncs in one of the TestSteps in the TestCase. 1. Run the acceptance test. Expect the test to fail. 1. If the test fails, then undo the edit and report a successful flip. Else, keep the edit and report an unsuccessful flip.