Content
65%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.
The skill body is efficient, well-sectioned, and gives concrete rule sources, report requirements, and output conventions. Its main weaknesses are a referenced bundle file that does not exist, missing validation checkpoints (rule-load failure, report-write verification), and a couple of vague operational steps (how to load rules, "line by line" review).
Suggestions
Fix the dangling reference: either bundle `Security_Code_Reviewer_Guidelines.md` (e.g. under `references/`) or remove/inline the instruction that points to it.
Add validation checkpoints: what to do if the CodeGuard rules cannot be fetched, and verify the report file was written to `./security_report/` before declaring completion.
Make rule loading executable — specify concrete retrieval (raw.githubusercontent.com URLs or a clone command) — and replace "Review the repository line by line" with a practical traversal strategy (e.g., by entry point, then by module).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's security knowledge (focus areas are listed as bare terms like "injection flaws, authn/authz, SSRF"), with only minor trimmable redundancy — e.g. "These are mandatory foundational rules that must be loaded for every review" restates the prior bullet, and the output path is explained twice. Not 5: a few sentences could be tightened without losing anything. | 4 / 5 |
Actionability | Concrete guidance includes exact rule-source URLs, an example invocation (`$security-review /path/to/repo`), a fully specified report structure, and a precise output path convention. Not 5: "Load all core security rules from <URL>" gives no mechanism (raw URLs? clone?), and "Review the repository line by line" is not executable guidance for a real repository. | 4 / 5 |
Workflow Clarity | The 3-step sequence (load knowledge base, analyze, report) is clearly ordered, and one checkpoint exists ("If the repo path is missing or unclear, ask the user for it before proceeding"), but other checkpoints are missing. Not 4: there is no validation for failed rule loading (network/missing URL), no check that the report was written successfully, and no guidance on handling an empty or unwritable target. | 3 / 5 |
Progressive Disclosure | Sections (When to use, Inputs, Workflow, Report requirements, Output) are well organized and the body is short, but the body directs the reader to "the `Security_Code_Reviewer_Guidelines.md` file bundled with this skill", and no such file exists anywhere in the skill bundle — a dangling reference that breaks navigation. Not 4: the one referenced bundle file is missing, so the structure cannot be relied on; not 2: the body itself is appropriately sized and does not inline material that belongs in separate files. | 3 / 5 |
Total | 14 / 20 Passed |