Content
60%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 delivers strong operational intelligence (verified parameters, response shapes, fallbacks, and clinical reasoning tiers) but is undercut by a dangling reference to a nonexistent ANALYSIS_DETAILS.md and inline bulk that belongs in reference files. Conceptual biology explanations Claude already knows pad the token cost.
Suggestions
Create the referenced ANALYSIS_DETAILS.md with the per-phase code snippets and API call patterns, or remove the reference at line 111.
Move the long tool-reference tables (Gene Resolution, Drug Information, Mutation Prevalence, etc.) into a separate reference file (e.g., references/TOOL_REFERENCE.md) and keep only the most-used tools in SKILL.md.
Trim explanations of concepts Claude already knows (oncogene vs tumor suppressor roles, driver/passenger basics) down to the tool-specific decision guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The tool-parameter tables and verified response fields are dense, high-value content, but the body re-explains biology Claude already knows (e.g., 'Genes like EGFR, BRAF, KRAS, TP53, PIK3CA are well-established cancer drivers', 'Not every mutation in a tumor is driving the cancer') and several justification paragraphs could be trimmed. | 3 / 5 |
Actionability | Concrete tool names, exact parameter corrections ('ensemblId (camelCase)', 'ALL 4 required'), response key fields, and a verified worked example make most guidance executable. However, per-phase 'detailed code snippets and API call patterns' are deferred to ANALYSIS_DETAILS.md, which does not exist in the bundle. | 4 / 5 |
Workflow Clarity | A clear 8-phase sequence with a Phase 0 parameter-verification checkpoint, an explicit fallback strategy, and a documented retry-once behavior for IntOGen timeouts. Checkpoints remain at overview level since per-phase detail is deferred to the missing reference file. | 4 / 5 |
Progressive Disclosure | The sole reference, 'For detailed code snippets and API call patterns for each phase, see ANALYSIS_DETAILS.md', points to a file that does not exist, and large tool-reference tables that belong in a separate file are inlined in SKILL.md. | 2 / 5 |
Total | 13 / 20 Passed |