Content
81%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 well-structured, mostly lean workflow with clear phase sequencing, explicit fallbacks, and error-recovery loops. The main improvements are deduplicating the reasoning guidance, providing one worked end-to-end example call with real values, and splitting the extended tool catalog into a reference file.
Suggestions
Deduplicate the replicate-priority and RNA-seq/microarray platform guidance, which appears verbatim in both 'Domain Reasoning' and 'Reasoning Framework' — keep one authoritative statement.
Replace the '[gene/disease]'-style placeholders in the Phase 2 code block with one worked end-to-end example using real values (e.g., a specific gene, species, and resulting accessions), as the Bgee and GxA entries already do.
Move the extended Additional Sources tool descriptions (GxA, ARCHS4, Bgee paragraphs) and Search Parameters into a references/ file, keeping only a one-line summary per tool in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean — tables for query strategies, fallback chains, error responses, and quality tiers, with no padding or explanation of concepts Claude already knows. It is not a 5 because 'Prioritize >=3 biological replicates, complete annotations, and both raw+processed data' and the RNA-seq/microarray dynamic-range comparison appear verbatim in both 'Domain Reasoning' and 'Reasoning Framework', a trimmable duplication. | 4 / 5 |
Actionability | Concrete parameterized tool calls (tu.tools.arrayexpress_search_experiments(keywords=..., species=..., limit=20)), fallback chains, and per-error response tables make the guidance mostly executable. It falls short of 5 because the main code block uses placeholders ('[gene/disease]', '[species]') rather than a worked example with real values — only the Bgee/GxA blurbs include concrete IDs and parameters. | 4 / 5 |
Workflow Clarity | Phases 0-3 are explicitly sequenced with skip/ask conditions in Phase 0, disambiguation strategy in Phase 1, fallback chains in Phase 2, and a structured report with quality scoring in Phase 3. Error handling provides explicit feedback loops ('Broaden keywords, remove species filter, try synonyms'; 'Retry once'), and the Synthesis Questions act as a validation checklist, matching the score-5 anchor. Retrieval is read-only, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The single file is well-organized with clear section headers and no nested references, and no bundle files exist. It is not a 5 because ~20 lines of extended tool-reference material (the long GxA, ARCHS4, and Bgee paragraphs plus Search Parameters) is inlined API documentation that could live in a references/ file, leaving the overview less lean than the anchor requires. | 4 / 5 |
Total | 17 / 20 Passed |