Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that clearly covers three workflows for acceptance testing in Terraform providers. Its main strength is the clear sequencing of diagnostic escalation steps and the flip-test procedure. The only notable weakness is that it could be slightly more actionable with a complete copy-paste-ready command example combining the env vars and go test invocation.
Suggestions
Add a complete, copy-paste-ready command example, e.g., `TF_ACC=1 go test -run=TestAccFeatureHappyPath ./...` to improve actionability.
Consider adding a brief concrete example of editing a TestCheckFunc value for the flip procedure to make that workflow fully actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It assumes Claude knows Go testing, Terraform, and environment variables. Every line provides actionable information without unnecessary explanation. | 3 / 3 |
Actionability | Provides specific commands, environment variables, and flags, but lacks a complete executable example (e.g., the full `go test` command with env vars inline). The 'flip' procedure describes editing TestCheckFuncs but doesn't give a concrete code example of what to change. | 2 / 3 |
Workflow Clarity | Three distinct workflows (running, diagnosing, flipping) are clearly sequenced with explicit steps. The diagnosis workflow is cumulative and well-ordered. The flip workflow includes a validation/feedback loop (check if test fails, then undo or report). Missing env var handling is addressed with a conditional step. | 3 / 3 |
Progressive Disclosure | For a simple, focused skill under 50 lines with no need for external references, the content is well-organized into three clear sections (running, diagnosing, flipping) with logical grouping. No bundle files are needed. | 3 / 3 |
Total | 11 / 12 Passed |