Content
82%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 tight, well-structured hunting skill that assumes Claude's competence and leads with concrete artifacts (CWE table, semgrep command, report template, quality gate). The main gap is that several workflow steps stay at the guidance level rather than giving executable specifics, and the validation feedback loop is implicit rather than spelled out.
Suggestions
Tighten a couple of abstract workflow steps into concrete actions, e.g. for 'Prove user control reaches a meaningful sink' give an example trace technique (grep from entrypoint to sink, or a curl invocation shape).
Make the validate-fix-retry loop explicit in the Workflow or Quality Gate, e.g. 'If a quality-gate check fails, fix and re-run the PoC before drafting the report.'
Consider extracting the report-structure template and CWE pattern table into a reference file so the SKILL.md body stays a lean overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense: a CWE-pattern table, a skip list, a numbered workflow, one executable semgrep command, a report template, and a quality-gate checklist, with no padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Provides an executable semgrep command, a concrete triage filter list, a copy-paste report template, and a quality-gate checklist, but several workflow steps ('Read the real code path end to end', 'Prove user control reaches a meaningful sink') are high-level guidance rather than executable specifics. | 4 / 5 |
Workflow Clarity | A clear 7-step sequence is present and the 'Quality Gate' section supplies an explicit pre-submission validation checkpoint for an outward-facing operation, but there is no explicit validate-fix-retry feedback loop, keeping it below the top anchor. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with no nested or buried references, and the skill is appropriately self-contained with no bundle files; at ~90 lines it sits just above the under-50-line simple-skill exception that would allow a 5. | 4 / 5 |
Total | 17 / 20 Passed |