Content
77%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 well-engineered audit runbook: concrete commands, strong validation loops, and best-in-class progressive disclosure into verified one-level-deep references. The two deductions are inline evergreen framework checklists and dated version specifics that inflate token cost without adding Claude-unknown knowledge (conciseness 3), and a handful of table-escaped grep patterns plus allowed-tools mismatches that break copy-paste fidelity (actionability 4).
Suggestions
Move the Step 3 evergreen framework anti-pattern checklists (Next.js/Django/Rails/Express/Spring/Laravel/WordPress lists) into a references file (e.g. references/framework-checklists.md), keeping only a pointer plus the non-obvious entries (serverless in-memory state, server-only import boundary) inline — this would lift conciseness from 3 toward 5.
Quarantine time-sensitive specifics (CVE-2025-29927, libvips ≥ 8.13, the October 2026 field-note details) into the references or an explicitly dated section so the inline body doesn't rot, per the skill's own 'advisory lists rot fast' warning.
Fix the Step 5b table greps so they are copy-paste correct: rewrite pipe-containing patterns to avoid markdown-table escaping (e.g. separate grep -nE 'workflow_run|pull_request_target' lines outside the table, or use a different alternation form), and align the frontmatter allowed-tools with every command the body suggests (pip audit, safety check, cargo audit, docker scout cves).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Much of the ~410-line body is genuinely non-obvious operational knowledge that earns its tokens (pnpm --fix writing open-ended '>= overrides', singleton duplication, engines-floor raises, serverless in-memory state ≠ rate limit, the CI trust-handoff table). But the evergreen framework anti-pattern checklists in Step 3 (~90 lines: 'DEBUG=True in production', 'Default admin username, weak passwords', 'eval() or Function() with user input', 'Mass assignment without strong parameters') largely restate what Claude already knows and could be compressed or moved to a reference, and time-sensitive specifics (CVE-2025-29927, 'libvips ≥ 8.13', 'October 2026' field notes, 'next@16 to next@9') are inline rather than quarantined in a dated section. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances of over-explanation'. | 3 / 5 |
Actionability | Nearly everything is copy-paste executable: per-ecosystem audit commands, concrete grep one-liners for source redirection and unpinned MCP servers, a dry-run-first fix procedure, a post-fix verification checklist, a validate-until-exit-0 findings pipeline, and a complete output template. The gap that keeps it below anchor 5: the Step 5b table greps embed markdown-escaped pipes ('grep -nE "workflow_run\|pull_request_target"', 'docker (pull\|tag\|push)\|crane copy') which, copied verbatim, match a literal '|' instead of alternation and silently fail, and several suggested commands (pip audit, safety check, cargo audit, docker scout cves) are not in the frontmatter's allowed-tools. These are minor gaps, matching anchor 4 ('mostly executable; concrete commands with minor gaps') rather than fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | The methodology is a clearly sequenced Step 0→1→2→3→4→5→5b→diff-scoped pipeline with explicit validation checkpoints and feedback loops throughout: 'ALWAYS dry-run first' before --force, a verify-after-fixing checklist (re-audit, frozen install, smoke test), 'run node references/validate-findings.mjs findings.json until it exits 0', needs_validation dispositions for unverified platform facts, and a 'Rejected (do not re-raise)' table to prevent re-raising. Destructive lockfile-rewriting commands are gated (only when asked, on a branch, never production). This matches anchor 5 (clear sequence, explicit validation, feedback loops, checklists) exactly. | 5 / 5 |
Progressive Disclosure | Structure is exemplary and verified against the actual bundle: every inline citation ([references/fixing-safely.md] §6–10, [references/source-redirection.md] §1–3, [references/ci-release.md], [references/diff-review.md], [references/findings-format.md], [references/severity-calibration.md], [references/verification.md], validate-findings.mjs) points to a real file whose section anchors match, all references are exactly one level deep and clearly signaled with their purpose stated, bulk detail is correctly split out (fix traps, per-ecosystem redirection tables, handoff rules, findings schema) while only operational summaries stay inline. Navigation is easy via numbered steps and cross-references to sibling skills. This matches anchor 5. | 5 / 5 |
Total | 17 / 20 Passed |