Content
83%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.
A highly actionable, well-sequenced skill body with executable examples and validation-driven workflows. Its weakness is progressive disclosure: large reference tables are inlined rather than split into the referenced (but missing) bundle files, so the SKILL.md carries content that should live one level deeper.
Suggestions
Move the dense lookup tables (IAM Privilege Escalation Patterns, IAM Finding Severity Guide, S3/SG check matrices, Provider Coverage Matrix) into references/ files (e.g. the already-referenced cspm-checks.md) and link them from the body, keeping SKILL.md as an overview.
Create the referenced scripts/cloud_posture_check.py and references/cspm-checks.md so the in-text links resolve to real bundle files rather than dangling references.
Trim restated context Claude already knows — the repeated 'this is NOT incident-response / pen-testing' framing and explanatory sentences bracketing self-explanatory tables — to tighten conciseness toward a lean 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient: dense reference tables (exit codes, severity matrices, port rules) and executable bash earn their tokens, but the prose restates some concepts Claude already knows (e.g., the 'This is NOT incident response' framing and explanatory sentences around tables) that could be trimmed. Falls just above the midpoint between efficient (4) and lean (5). | 4 / 5 |
Actionability | Copy-paste-ready bash and HCL examples cover the common cases (IAM/S3/SG checks, AWS CLI pipes, CI/CD gating, Terraform bad-vs-good), with concrete flags (--check, --severity-modifier) and exit-code semantics — fully executable guidance. | 5 / 5 |
Workflow Clarity | Three explicitly sequenced workflows (20-min quick check, multi-day assessment, CI/CD gate) with a validation checkpoint: Workflow 3 validates IaC findings via exit code 2 and blocks deployment, and exit codes 0/1/2 define the remediation decision loop. Re-reading anchors, this matches the explicit-validation anchor better than the score-4 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The body is a single ~340-line SKILL.md with a heavy inlined reference layer (severity matrices, port tables, coverage matrix) that belongs in separate files, and the only external pointer — 'references/cspm-checks.md' and scripts/cloud_posture_check.py — cannot be verified because references/ and scripts/ directories are absent from the bundle, leaving references structurally buried and unsupported. | 3 / 5 |
Total | 17 / 20 Passed |