Content
77%Reviews 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 clear phased workflow, checklists, and error-handling feedback, but it is lengthy for a single file and lacks progressive disclosure via separate reference files.
Suggestions
Move the full report output template and the Tool Reference / Search Parameters tables into a separate reference file (e.g. REPORT_TEMPLATE.md) and link to it from the main body to improve progressive disclosure.
Trim duplication between the inline code examples and the Tool Reference / Search Parameters tables to reduce token usage.
Consider extracting the Data Quality Tiers and Completeness Checklist into a reference document, keeping the main SKILL.md focused on the workflow overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and free of basic-concept filler, but the ~110-line report template and the separate Tool Reference / Search Parameters tables duplicate information already shown in the code examples and could be tightened. | 2 / 3 |
Actionability | Provides fully executable tool calls with real method names and parameters, plus fallback chains, error-handling tables, parameter references, and worked use-case examples that are copy-paste ready. | 3 / 3 |
Workflow Clarity | A clear Phase 0–3 sequence with an overview diagram, plus feedback loops (error-handling table with retry/broaden-keyword guidance) and checklists (gene disambiguation, completeness) for the multi-step retrieval-and-report process. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the skill is a single monolithic ~385-line file; content that could be split out (the large output template, tool/parameter reference tables) is inline rather than referenced one level deep. | 2 / 3 |
Total | 10 / 12 Passed |