Content
92%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 excellent, dense skill body: fully executable commands with agent-safety masking built in, a validated findings-first output workflow with explicit feedback loops, and an appropriate split between the inline operational content and four real one-level-deep reference files. The only weakness is minor — a few framing sentences and a general references list that could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and high-signal — provider-prefix grep tables, tooling matrix, agent-config location table, exfiltration domains — with almost no explanation of concepts Claude already knows. Minor trimmable material remains (the 'Most secret leaks aren't…' framing sentence, the cross-references paragraph, and the trailing general 'References' list), which fits the 4 anchor 'minor instances of over-explanation that could be trimmed' rather than the 5 anchor's every-token-earns-its-place. | 4 / 5 |
Actionability | Copy-paste-ready, executable commands throughout: provider-specific grep/rg regexes (e.g. `grep -rlE "(AKIA|ASIA)[A-Z0-9]{16}" .`, the masked `rg -o -r '$1…$2'` pattern), git-history sweeps, trufflehog invocations, MCP-config scan pipelines, and the validator command `node references/validate-findings.mjs findings.json`. Placeholders like `<first-commit>` and `<image>` are repo-specific parameters, not pseudocode; common cases are covered. | 5 / 5 |
Workflow Clarity | The 'Triaging a found secret' section is a numbered 8-step sequence with explicit validation checkpoints (verify it's live, exposure window, blast radius, audit for use), and the Output Format section mandates a validate-then-render feedback loop ('fix every error before writing prose'). Destructive history rewrites are gated on explicit confirmation and coordination, and the posture audit has a checklist — matching the 5 anchor's sequence + validation + feedback loops + checklist. | 5 / 5 |
Progressive Disclosure | The split matches the actual bundle: operational scanning guidance stays in SKILL.md while the findings record schema, SARIF export, the per-finding refutation pass, and severity calibration are each pushed to a clearly signaled, one-level-deep reference ([references/findings-format.md], [references/validate-findings.mjs], [references/verification.md], [references/severity-calibration.md]) — all verified to exist, none nesting further. Sections are well-organized and easy to navigate. | 5 / 5 |
Total | 19 / 20 Passed |