Content
75%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 verified, copy-paste-ready commands and a well-sequenced workflow including verification and failure-handling feedback loops. Its main weaknesses are redundant routing restatements that hurt conciseness and a monolithic structure that keeps reference-grade detail inline.
Suggestions
Consolidate the backend routing rules so they appear once (table or bullets) and remove the repeated 'explicit only' reminders in each backend section.
Move the 10 reference-quality rules and the full CLI flag catalog into a separate REFERENCES.md linked from the body to improve progressive disclosure and reduce SKILL.md length.
Add an explicit 'if Extract verification fails or the reference shortfall persists -> refine the query/date range/domains and re-run' loop directly inside step 2/3 of the manuscript workflow to lift workflow clarity to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1600-word body is operational rather than padded with known concepts, but routing rules are restated multiple times (the routing table, the 'Important compatibility behavior' bullets, and each backend section's 'explicit only' reminder), so it could be meaningfully tightened. | 3 / 5 |
Actionability | Eight copy-paste bash invocations and a JSON context example, all using flags verified to exist in scripts/research_lookup.py, cover the academic, deep-research, chat, Perplexity, fast-lookup, and batch cases — fully executable. | 5 / 5 |
Workflow Clarity | A clear 5-step numbered manuscript workflow with an explicit verification step (Extract) and feedback loops in Failure handling (shortfall -> inspect coverage.json -> refine), but the validate->fix->re-verify loop is not woven as crisply into the main sequence as the 5-anchor example. | 4 / 5 |
Progressive Disclosure | Well-organized with clear headers and one-level references to real bundle scripts (research_lookup.py, manuscript_packet.py) with no nested references, but the single ~320-line file inlines the 10 quality rules and full flag coverage that could split into separate reference docs. | 4 / 5 |
Total | 16 / 20 Passed |