Content
96%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 a tightly written, highly actionable multi-phase workflow with strong validation and feedback loops. Its only gap is that the five referenced companion files are not present in the bundle to confirm the progressive-disclosure structure resolves as signaled.
Suggestions
Ship the five referenced companion files (TOOL_NAMES_REFERENCE.md, REPORT_TEMPLATE.md, FULLTEXT_STRATEGY.md, WORKFLOW.md, EXAMPLES.md) in ./references/ so the signaled navigation actually resolves.
Consider a one-line note in the References section clarifying each file's trigger (e.g., 'open when writing the report' for REPORT_TEMPLATE.md) to make progressive disclosure intent explicit.
Verify referenced tool names and parameters against TOOL_NAMES_REFERENCE.md so the inline signatures stay accurate as the tool set evolves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and bullet/table-driven with no padding about concepts Claude already knows; every line carries a tool name, parameter, or decision rule, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | Provides executable tool-call signatures (e.g., "EuropePMC_search_articles(query=\"term1 term2 term3\", limit=5)") and concrete query templates with collision filters, matching the copy-paste-ready anchor. | 5 / 5 |
Workflow Clarity | Clear four-phase sequence (Phase 0→1→2→3) with explicit validation checkpoints and feedback loops — collision detection (">20% off-topic"), PubMed zero-result fallback ("Always retry with EuropePMC... not optional"), and retry→fallback chains — matching the explicit-validation-with-error-recovery anchor. | 5 / 5 |
Progressive Disclosure | Well-organized body with a clear References section signaling five one-level-deep files (TOOL_NAMES_REFERENCE.md, REPORT_TEMPLATE.md, etc.), but the referenced bundle files are not present in ./references/ to verify, so it sits just below the fully-resolved one-level-deep anchor. | 4 / 5 |
Total | 19 / 20 Passed |