Content
82%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-structured skill body: executable commands with flags and exit codes, concrete workflows with decision rules, good/bad IaC examples, and a genuine one-level-deep reference file. The main costs are a redundant table of contents, meaningful duplication between the inline check matrices and references/cspm-checks.md, and missing Azure/GCP export steps in the workflows.
Suggestions
Deduplicate the IAM privilege-escalation pattern table and S3 check matrix against references/cspm-checks.md — keep only a condensed severity summary inline and let the reference file carry the full rows, reclaiming ~30 lines of token budget.
Add Azure/GCP export command examples (or note that workflows currently cover AWS only) so the advertised 'Partial' provider coverage in the coverage matrix is actionable end-to-end.
Drop the table of contents and add a short error-recovery note for malformed input JSON to lift workflow clarity to a full validation loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely dense, signal-bearing tables and commands with essentially no explanation of concepts Claude already knows, matching 'efficient; minor instances of over-explanation that could be trimmed'. Not 5 because the 16-line table of contents is redundant with section headers, and the IAM privilege-escalation pattern table and S3 check matrix substantially duplicate content already in references/cspm-checks.md; not 3 because there is no real padding and every section carries actionable specifics. | 4 / 5 |
Actionability | The content is copy-paste ready throughout: exact tool invocations with flags ('python3 scripts/cloud_posture_check.py policy.json --check iam --json'), an exit-code table mapping codes to required actions, complete bash pipelines combining AWS CLI and jq, a BAD/GOOD Terraform pair, and severity modifiers with concrete usage conditions. The referenced script exists in the bundle, and the examples cover the common cases (IAM, S3, security groups, CI/CD gate), matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | Three workflows are clearly sequenced — Workflow 1 pairs numbered commands with an explicit decision rule ('Exit code 2 = block deployment... Exit code 1 = schedule remediation within 24 hours'), and Workflow 3 embeds an exit-code validation gate. This matches 'clear sequence with most checkpoints present; minor validation gaps'. Not 5 because there are no error-recovery steps (e.g., what to do if the exported JSON does not match the expected input format) and no export commands for Azure/GCP even though the coverage matrix advertises partial support for them. | 4 / 5 |
Progressive Disclosure | Structure is good: a navigable table of contents, per-domain sections, and a real, clearly signaled one-level-deep reference ('Full CSPM check reference: references/cspm-checks.md', also cited in Workflow 2) that exists in the bundle. This matches 'good structure; most content is appropriately placed; minor organization gaps'. Not 5 because the inline IAM and S3 check tables duplicate much of references/cspm-checks.md, so the split between overview and detail file is not as clean as it could be. | 4 / 5 |
Total | 17 / 20 Passed |