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 body is highly actionable with concrete commands and clear sectioning, but it is verbose (repeated tables, inline reference-grade material) and lacks validation checkpoints for its batch operations.
Suggestions
Move the API-key management and full platform-detection procedure into a reference file (e.g. references/setup.md) and link to it, keeping SKILL.md to the fast-path cheat sheet and a one-line fallback pointer.
Deduplicate the command tables — keep one invocation reference instead of repeating the per-runtime doc and invocation tables.
Add an explicit validation checkpoint for batch_search results (e.g. verify each item's status/error field before reporting success) to satisfy the feedback-loop requirement for batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and free of generic concept explanations, but ~186 lines repeat the command tables (cheat sheet plus platform-detection invocation table) and spell out the full detection procedure inline that runtime.conf is meant to bypass. | 2 / 3 |
Actionability | Provides exact, copy-paste command shapes with realistic examples (AAPL/MSFT, JSON batch queries) and explicitly flags invalid forms ('do not use extract --format markdown'), matching fully executable guidance. | 3 / 3 |
Workflow Clarity | Detection and key-persistence flows are sequenced with fallbacks, but batch_search is a batch operation with no agent-side validation/verification checkpoint — the rubric caps workflow_clarity at 2 when batch ops lack validation. | 2 / 3 |
Progressive Disclosure | References real bundle scripts (anysearch_cli.{py,js,ps1,sh} exist) and uses clear headers, but API-key management and the full platform-detection procedure are inline rather than split out, and doc_spec.md is only reachable via the doc command rather than a signaled link. | 2 / 3 |
Total | 9 / 12 Passed |