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 concrete tool signatures, exact parameter gotchas, and a clearly sequenced three-step workflow backed by cross-database validation and evidence tiers. Its main weaknesses are some prose reasoning that could be tightened for conciseness and a monolithic single-file structure with no progressive disclosure to external reference files.
Suggestions
Tighten the 'Core Reasoning Principles' section: convert the TCF7L2 and NF-kB worked prose into terse bullet guidance to cut tokens while keeping the reasoning intent.
Externalize the detailed 'Tool Selection Guide' parameter reference into a references/ file (e.g. TOOL_REFERENCE.md) and keep SKILL.md as an overview pointing to it, adding one-level-deep progressive disclosure.
Add explicit error-recovery feedback loops for common tool failures (e.g., 'if GTEx eQTL returns empty, fall back to GTEx_get_expression_summary across tissues') to harden the workflow checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and focused on ToolUniverse-specific knowledge Claude lacks (tool signatures, parameter gotchas), but the 'Core Reasoning Principles' section carries illustrative prose ('TCF7L2 is the strongest T2D GWAS gene. It participates in the Wnt signaling pathway...') that could be tightened. It is not score 3 because some explanatory worked examples pad the token budget; it is not score 1 because it avoids explaining basic concepts Claude already knows (no 'what is a pathway/SNP'). | 2 / 3 |
Actionability | Concrete tool invocations with exact parameter names and values are given throughout, e.g. `gwas_get_variants_for_trait(trait=<trait>, p_value_threshold=5e-8)` and `ReactomeAnalysis_pathway_enrichment(identifiers="P04637 P38398 ...")`, plus a 'COMPUTE, DON'T DESCRIBE' directive to run Python. The per-tool gotchas make the calls actually executable correctly, satisfying copy-paste-ready concrete guidance rather than the pseudocode/vague score-2 case. | 3 / 3 |
Workflow Clarity | A clearly sequenced Three-Step Workflow (GWAS→causal gene; gene set→pathway enrichment; pathway→drug target) with explicit validation checkpoints: multi-database convergence ('pathways appearing across multiple databases = stronger evidence'), High/Medium/Low evidence tiers as a checklist, and 'Cross-reference pathway genes with GWAS genes: overlap = top candidate.' It is not score 2 because checkpoints are explicit rather than implicit; the destructive/batch feedback-loop cap does not apply to this analytical retrieval workflow. | 3 / 3 |
Progressive Disclosure | The body is well-organized into clear sections (When to Use, Core Reasoning Principles, Tool Selection Guide, Three-Step Workflow, Key Parameter Gotchas, Limitations), but it is a monolithic single SKILL.md with no bundle files (no references/, scripts/, assets/) and substantial reference-style content (full tool parameter listings) kept inline. It is not score 1 because sectioning and header navigation are good; it is not score 3 because there is no one-level-deep file split and API-reference-style detail is not externalized. | 2 / 3 |
Total | 10 / 12 Passed |