Content
78%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 body is highly actionable with executable commands and a clear five-step workflow, kept mostly lean with only minor padding in the tools/concepts tables. Its main structural flaw is progressive disclosure: the bundled API reference and agent script are never surfaced, leaving useful material orphaned.
Suggestions
Add a short 'Reference files' or 'Automation' section pointing to references/api-reference.md and scripts/agent.py (e.g., 'For a runnable collection agent, see scripts/agent.py; full function/API details in references/api-reference.md') so the bundle is discoverable.
Trim or merge the Tools & Systems section with Prerequisites — the one-line tool blurbs ('50+ data source transforms', '1B+ indexed devices') add marketing-style padding Claude does not need.
Prune Key Concepts entries Claude already knows (ASN, Certificate Transparency) and keep only operational terms specific to this workflow (PIR, pivoting, co-hosted domains); move pivot-verification guidance from Common Pitfalls into the Maltego workflow step as an inline checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Workflow steps are lean with tight, purposeful code blocks and no filler prose. Minor over-explanation remains: the 'Tools & Systems' one-liners largely duplicate Prerequisites, and the Key Concepts table defines things Claude already knows (ASN, Certificate Transparency). | 4 / 5 |
Actionability | Copy-paste-ready guidance throughout: curl commands for SecurityTrails and crt.sh with jq, a whois command, executable Shodan Python, a numbered Maltego transform sequence with exact transform names, and a SpiderFoot CLI invocation — the common OSINT collection cases are all covered concretely. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps (define collection requirements → passive DNS/WHOIS → Shodan mapping → Maltego graph analysis → dark web monitoring), each with a stated purpose. Verification exists but is scattered ('Verify each pivot independently' sits in Common Pitfalls) rather than explicit inline checkpoints, and passive OSINT is not a destructive/batch operation so the validation cap does not apply. | 4 / 5 |
Progressive Disclosure | Body sections are well organized, but the bundle ships references/api-reference.md and scripts/agent.py and the body never references either file — the API reference and the runnable collection agent are orphaned and undiscoverable, and inline Shodan/curl details partially duplicate what api-reference.md already documents. This matches 'references present but not clearly signaled' rather than a minor organization gap. | 3 / 5 |
Total | 16 / 20 Passed |