Content
81%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 a complete, validated workflow and strong error-recovery guidance. Its weaknesses are repeated installation instructions across three sections and reference-worthy content (Installation, Pitfalls) inlined in a fairly long single file.
Suggestions
Consolidate the three copies of install instructions (Requirements, step 1, Installation section) into one place and reference it from the others.
Drop the duplicated "Example terminal call" JSON block or the repeated default command in step 3 — one of the two suffices.
Move the Installation and Pitfalls sections into a reference file (e.g. INSTALL.md / TROUBLESHOOTING.md) to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Installation instructions are repeated three times (Requirements, step 1's install offer, and the dedicated Installation section with the same pipx/pip/Docker commands), and the "Example terminal call" JSON block duplicates the step-3 command. This is mostly efficient but with several redundant sections that could be tightened, matching anchor 3 rather than the minor-trim case of anchor 4. | 3 / 5 |
Actionability | The skill provides an exact default command with flags ("sherlock --print-found --no-color \"<username>\" --timeout 90"), an executable example terminal call, concrete output-parsing examples, and a full worked example interaction with a response format. Everything is copy-paste ready and covers the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (install check, username extraction, command build, execute, parse/present) is paired with an explicit Verification checklist and a Pitfalls section with error-recovery guidance for no results, timeouts, Tor, false positives, and rate limiting. The operation is a read-only single search, so the batch/destructive cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a single well-sectioned SKILL.md with no bundle files and clear headers, so navigation is easy and references are one level (none). However, at ~180 lines, the Installation and Pitfalls sections are content that could be split into reference files to keep the overview lean, matching anchor 4's minor organization gaps rather than a lean overview. | 4 / 5 |
Total | 17 / 20 Passed |