Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is actionable and has a clear, well-sequenced setup workflow with a feedback loop, but it is let down by a path-resolution inconsistency that breaks copy-paste usability and by references to unbundled scripts. Trimming marketing and integration sections would improve token efficiency.
Suggestions
Make every command example use the resolved `$OPEN_TARGETS_SCRIPT` path so examples are truly copy-paste ready, instead of mixing in relative `scripts/search` forms.
Trim the 'Why This Skill is Powerful' marketing bullets and move the Python/TypeScript integration snippets to a separate reference file.
Ensure the referenced `scripts/search` and `scripts/search.mjs` files actually ship in the bundle, or note their absence explicitly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete command examples and no basic-concept explanations, but the 'Why This Skill is Powerful' marketing bullets and the inline Python/TypeScript integration sections add padding that could be trimmed. | 2 / 3 |
Actionability | Commands are concrete, but the later examples use the relative form `scripts/search "query"` which the skill's own CRITICAL section warns will not resolve — so examples are not truly copy-paste ready, matching the incomplete-guidance anchor. | 2 / 3 |
Workflow Clarity | The API-key setup flow is a clear sequenced process with a `setup_required` feedback loop and explicit retry step, and error handling (success field, exit codes) is documented, matching the top anchor. | 3 / 3 |
Progressive Disclosure | The skill is a single well-sectioned file, but it references a `scripts/` directory that is not present in the bundle and keeps integration material inline that could be split out, so it is not cleanly one-level-deep. | 2 / 3 |
Total | 9 / 12 Passed |