Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid security review skill with strong actionability through concrete tool commands and an excellent example finding entry. The workflow is well-sequenced with appropriate authorization gates and validation checkpoints. The main weaknesses are minor verbosity in constraint lists and the inability to verify that the six referenced files actually exist in the bundle, which limits the progressive disclosure score.
Suggestions
Trim the 'When to Use This Skill' section since it largely duplicates information already conveyed by the workflow steps and skill description.
Move the flat 'Knowledge Reference' list into a reference file or remove it entirely — Claude already knows these tools and standards, and the list adds no actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but has some unnecessary padding. The 'When to Use This Skill' section largely repeats the workflow steps. The MUST DO/MUST NOT DO lists contain some items Claude would already know (e.g., 'don't share detailed exploits publicly'). The Knowledge Reference section is a flat list of tool names that adds little actionable value. | 2 / 3 |
Actionability | Provides concrete, executable tool commands (semgrep, bandit, gitleaks, npm audit, trivy), a detailed example finding entry with specific code showing both the vulnerable and remediated pattern, and clear severity rating guidance using CVSS. The example finding is copy-paste ready and demonstrates the expected output format precisely. | 3 / 3 |
Workflow Clarity | The 5-step core workflow is clearly sequenced with explicit validation checkpoints: authorization verification before testing (steps 1 and 4), mandatory manual review after automated scanning (step 3), stakeholder confirmation before finalizing reports (step 5), and immediate reporting of critical findings. The workflow includes a feedback loop of verify-then-proceed and appropriately gates destructive/active testing behind authorization checks. | 3 / 3 |
Progressive Disclosure | The reference table with 'Load When' guidance is well-structured and clearly signals when to load each reference file. However, no bundle files were provided, so the six referenced files (references/sast-tools.md, etc.) cannot be verified to exist. The main SKILL.md itself is moderately long but not excessively so; some content like the Knowledge Reference list could be moved to a reference file. | 2 / 3 |
Total | 10 / 12 Passed |