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.
A well-structured, high-signal security skill whose body serves as an operational rulebook with implementations correctly pushed one level deep into a real, anchor-linked reference file. The main defects are a repeatedly referenced checklist file that is missing from the bundle and two tables that restate knowledge Claude already has.
Suggestions
Fix or inline the ../../references/security-checklist.md references — the path escapes the skill bundle and does not resolve, leaving the Review Checklist section, the destructive-paths worked code, and the dependency manager matrix pointing at nothing.
Trim the Common Rationalizations table to the rows that arm the agent against user pushback it will actually face, and compress the STRIDE table to the threat-to-mitigation pairs not already standard knowledge.
Inline one short worked example (e.g., a parameterized query or the destructive-path check as code) for the highest-risk control so executable guidance does not depend entirely on reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is rule-first and dense with almost no explanation of concepts Claude already knows, and sections like SSRF ('resolve all DNS records and reject any private or reserved address (loopback, link-local 169.254.169.254...)') and destructive paths carry non-obvious specifics. The 12-row 'Common Rationalizations' table and the STRIDE table partially restate security knowledge Claude already has and could be trimmed. | 4 / 5 |
Actionability | Directives are concrete and executable throughout — 'bcrypt (≥12 rounds)', 'httpOnly, secure, and sameSite: lax or strict', 'about 10 attempts per 15 minutes', 'npm audit signatures', and the three-part destructive-path check. No inline worked code is provided (it is delegated to references), and one cited 'worked code' target (../../references/security-checklist.md) does not resolve within the bundle. | 4 / 5 |
Workflow Clarity | The threat-model process is a clear numbered sequence (map boundaries, name assets, STRIDE, abuse cases), the dependency workflow has explicit checkpoints ('stop on disagreement or competing lockfiles', 'verify with a clean frozen/immutable install'), and destructive operations get explicit validation ('On refusal, log the rejected target and stop' plus a Verification checklist item). A 12-item Verification checklist closes the loop, so the destructive-operations cap does not apply. | 5 / 5 |
Progressive Disclosure | Exemplary one-level-deep structure: references/hardening-patterns.md exists and all 15 anchor links in the body resolve to real headings, with an explicit 'Open the section you need when you reach that code, not before' disclosure policy. However ../../references/security-checklist.md is referenced three times (the entire Review Checklist section, the destructive-paths 'worked code', and the dependency manager matrix) yet is absent from the bundle and escapes the skill directory. | 4 / 5 |
Total | 17 / 20 Passed |