Content
71%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 dense, well-structured methodology body that assumes competence and gives concrete, specific guidance with a clearly sequenced, validation-checked pipeline. Its main weakness is progressive disclosure: it is a large monolith with no local bundle files, inlining reference material that could live in separate files.
Suggestions
Split the inlined reference tables (§8.1 asset taxonomy, §9 severity anchors, §7.2 time budgets, §12 breach sources) into local reference files (e.g. references/severity-rubric.md, references/asset-taxonomy.md) and link them from SKILL.md so the body acts as an overview rather than a 480-line monolith.
De-duplicate the repeated 'do not paste PII/creds into cloud LLMs' and 'single-source attribution' guidance — it appears in §1, §5, and §14 — into a single canonical location to recover tokens.
Add a short table-of-contents block near the top mapping each section to its purpose, so an operator can jump to the relevant stage without scanning the whole file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and information-rich with no basic-concept padding (it assumes Claude's competence and a deliberate trim history is documented), but the ~480-line body carries minor redundancy — the 'no PII/creds into cloud LLMs' and 'single-source attribution' guidance recurs across §1, §5, and §14. | 4 / 5 |
Actionability | Highly concrete guidance for an instruction skill — named tools (crt.sh, HudsonRock Cavalier, HIBP), exact probe paths (`.git/config`, `.env`, `/actuator/env`), a finding schema, severity anchors, and time-budget tables — but most copy-paste-ready commands/regexes are deferred to the companion skill rather than present here. | 4 / 5 |
Workflow Clarity | The 6-stage pipeline is clearly sequenced with explicit abort conditions, confidence-upgrade validation (TENTATIVE→FIRM→CONFIRMED), a §6.4 back-off feedback loop, and Stage-6 scope gating; minor gaps arise because per-stage module steps stay high-level with implementation pushed to the companion skill. | 4 / 5 |
Progressive Disclosure | Well-organized into 18 headed sections with clearly signaled pointers to the companion 'offensive-osint' skill, but as a standalone skill it is a monolithic ~480-line SKILL.md with zero local reference files — reference-style content (asset taxonomy, severity rubric, time budgets, breach-source tables) is inlined rather than split into local files the body points to. | 3 / 5 |
Total | 15 / 20 Passed |