Content
81%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a highly actionable, well-sequenced validation workflow with real one-level-deep bundle references and strong error-recovery guidance. Its weaknesses are padding: a redundant inlined remediation example and a closing section of standard terraform CLI commands Claude already knows.
Suggestions
Trim the closing "References" section to non-obvious invocations only — the standard `terraform fmt`/`validate`/`plan` flag examples (-out, -var-file, -target) re-teach CLI knowledge Claude already has.
Replace the full HCL remediation block in the example cross-referenced report with a one-line pointer like "remediation copied from security_checklist.md §Overly Permissive Security Groups", since the template already instructs copying from the reference file.
Consider moving the security report template and example into security_checklist.md alongside the Checkov ID mappings it depends on, keeping SKILL.md to the workflow and navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient tables and commands, but there are two padded areas: the ~40-line worked example report duplicates a full HCL remediation block that the template itself says to copy from security_checklist.md, and the trailing "References" section re-teaches standard terraform fmt/validate/plan CLI flags (e.g. `-out`, `-var-file`, `-target`) Claude already knows — fitting anchor 3 (some unnecessary explanation, could be tightened) rather than anchor 4's minor-trims profile. | 3 / 5 |
Actionability | Fully executable throughout: exact wrapper invocations with arguments (`bash scripts/run_checkov.sh <path>`), a numbered lookup workflow naming the exact MCP calls (`mcp__context7__resolve-library-id` with the WebSearch fallback string), a fill-in report template, and a concrete missing-tool dialogue with install commands — matching anchor 5 (copy-paste ready, covering common cases). | 5 / 5 |
Workflow Clarity | The 11-step ordered table marks Required vs Recommended gates, enforces ordering constraints (references read before scans), and provides explicit error-recovery feedback loops (Handling Missing Tools flow, common_errors.md error database) — matching anchor 5's clear sequence with explicit validation checkpoints and feedback loops; this is a validation-only skill that explicitly stops at plan, so no destructive-operation cap applies. | 5 / 5 |
Progressive Disclosure | All four reference files (security_checklist.md, best_practices.md, common_errors.md, advanced_features.md) and all four scripts exist in the bundle, are one level deep, and are well signaled via the When/File/Content table; however, the example report inlines a remediation code block that belongs in (and is stated to come from) security_checklist.md, a minor organization gap that keeps it at anchor 4 rather than anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |