Content
88%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.
An exceptionally actionable, well-sequenced audit skill with real validation loops (refutation pass, schema validator, re-run fingerprint matching) and a deliberate split of shared formats and per-platform commands into one-level-deep reference files. The main costs are length and time-stamped fleet-sweep narrative that pads the PaaS section and will age, plus a body that is denser than an ideal overview-first SKILL.md.
Suggestions
Move the October 2026 fleet-sweep anecdotes and per-check war stories into a short 'Evidence base' section in references/paas.md (or a dedicated casebook file), keeping the checks themselves in the body — this trims conciseness and removes time-sensitive detail from the always-loaded context.
Split the detailed verdict-table examples ('source: cli deployment from 96 days ago...') into references/findings-format.md alongside the other verdict guidance, keeping only the one-line verdict definitions inline.
Replace the 'IAM audit' trigger term in the description with cloud-posture-specific phrases (e.g., 'IAM wildcard,' 'overprivileged role') to avoid colliding with the sibling iam-audit skill this body already defers to.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operative content — commands, thresholds, verdict rules — and assumes Claude's competence rather than explaining what S3 or IAM is. It falls short of lean/anchor-5 due to narrative fleet-sweep anecdotes ('Each check below comes from a real fleet sweep in October 2026,' the 96-day-old-deploy story) and time-sensitive version/date details ('CVE-2026-66066,' 'Heroku-24 ships 8.15.1') that add tokens and will age, but well above the noticeably-verbose anchor-3. | 4 / 5 |
Actionability | Nearly every section is copy-paste-ready: exact CLI commands with jq projections ('vercel api "/v6/deployments?projectId=<id>&target=production&limit=5" | jq ...'), API endpoints, concrete thresholds (libvips ≥ 8.13, keys older than 90 days, check the last 10–20 deploys), a redaction-safe host-extraction one-liner, and a validator invocation ('node references/validate-findings.mjs findings.json'). Specific examples cover the common cases across all three clouds and six PaaS platforms. | 5 / 5 |
Workflow Clarity | The process is clearly sequenced — Authorization → Scope → Audit Categories → 'Verify, then record' steps 1–7 → Output Format → Boundaries — with explicit validation checkpoints and feedback loops: a refutation pass on every candidate before confirmation, 'write findings.json ... and fix until it passes' the validator, and re-run matching by fingerprint with re-reading rejected evidence. The verdict table defines exactly how to close each candidate, matching the anchor-5 pattern of sequence + explicit validation + error-recovery loops. | 5 / 5 |
Progressive Disclosure | Structure is good: detailed material is one level deep in real, well-signaled files linked at point of use ([references/paas.md], findings-format.md, verification.md, severity-calibration.md, validate-findings.mjs, to-sarif.mjs), each verified present and appropriately scoped, plus a References section with external docs. It misses anchor 5 because the ~310-line body is itself fairly monolithic — the PaaS section's worked examples and the long verdict-table examples are inline detail that could partly live in the references, leaving SKILL.md closer to an overview. | 4 / 5 |
Total | 18 / 20 Passed |