Content
65%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with concrete executable commands and a clear section structure, but it is a monolithic file with no progressive disclosure and lacks validation checkpoints in its workflow. Splitting reference material into bundle files and adding verification steps would improve it.
Suggestions
Add explicit validation/verification checkpoints to the OSINT workflow (Section 8), e.g., confirm scope/authorization before each data-source query and verify harvested data against a second source.
Split the large reference catalogs (API commands, Google dorks, output file spec) into bundle files under references/ and link to them from SKILL.md to apply progressive disclosure.
Trim conceptual padding such as the opening definition paragraph; assume Claude knows what OSINT is and keep only operational guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely a lean reference catalog of commands and dorks, but it includes some mild padding (e.g., the opening 'OSINT collects publicly available information...' and several prose explanation points) that could be tightened; not a 3 because not every token earns its place. | 2 / 3 |
Actionability | Provides numerous concrete, copy-paste-ready commands with placeholders — theHarvester invocations, curl calls to VirusTotal/Shodan/HIBP, trufflehog/gitleaks, dig, grep — matching the 'fully executable commands; copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | Section 8 gives a 9-step OSINT sequence, but it is a flat list with no validation checkpoints or verify-then-proceed feedback loops; per guidelines, missing validation in batch/fragile workflows caps workflow clarity at 2. | 2 / 3 |
Progressive Disclosure | The skill is a single monolithic SKILL.md (~225 lines) with no bundle files; while the 10 numbered sections provide reasonable organization, content that could be split (API reference, dork catalog, output spec) is inline, matching the 'some structure but content that should be separate is inline' anchor. | 2 / 3 |
Total | 9 / 12 Passed |