Content
88%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.
A highly actionable, well-sequenced reference: concrete tool signatures, runnable snippets, ID format notes, zero-result retry loops, a fallback table, and evidence-tier synthesis rules. Remaining room is marginal — trim the Claude-known histone-mark dictionary and deduplicate tools documented in both Reasoning and Phase sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tool-focused with no filler — each entry is parameters, defaults, and gotchas (e.g., "GTEx requires versioned GENCODE IDs", "first hit may not match"), and the deprecated eQTL Catalogue note with its reason is properly quarantined. It sits at 4 rather than 5 because portions restate knowledge Claude already has: the histone-mark dictionary ("H3K4me3 = active promoter... H3K9me3 = constitutive heterochromatin") and bivalent promoter explanation are standard epigenomics, and ReMap_get_transcription_factor_binding and jaspar_search_matrices are each documented twice (Reasoning sections plus Phases 2/6) — minor over-explanation that could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance throughout: seven runnable Python snippets with real arguments and expected result shapes (e.g., `tu.tools.GTEx_get_single_tissue_eqtls(gencode_id=["ENSG00000012048"])` with a Counter over `result["data"]`), exact parameter names with REQUIRED/default annotations, concrete ID formats ("ENSG00000012048.20", "chr17_43705621_T_C_b38"), and result-structure comments. This matches the 5 anchor 'copy-paste ready code; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Clear sequencing with explicit feedback loops: 'Classify the Question First' routes four question types to tool sets, Phases 0–8 give the execution order, and error recovery is explicit — "if 0 results, retry with assay_type='polyA plus RNA-seq'", "if 0 results, append 'tissue', 'epithelium', or 'cell'", plus a Fallback Strategies table and a synthesis rule requiring 3+ converging layers before high confidence. These retry/verification loops match the 5 anchor's 'explicit validation steps; feedback loops for error recovery'; the destructive/batch cap does not apply since all operations are read-only lookups. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), so this scores on the single file's internal organization — well-sectioned headers, a question-type router up top, phases, and a fallback table. Good structure with minor gaps: tool entries are brief enough to justify staying inline, but there is redundancy from describing tools in both the Reasoning sections and the Phase sections (jaspar, ReMap, UCSC cCREs each appear twice), which a split into a reference file could resolve — fitting the 4 anchor 'most content is appropriately placed; minor organization gaps' rather than 5's cleanly split overview. | 4 / 5 |
Total | 18 / 20 Passed |