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.
A well-structured, domain-specific reasoning guide with strong workflow sequencing and useful decision thresholds, weakened by concept re-explanation and the absence of any executable code or example tool invocations despite a compute mandate.
Suggestions
Trim the Overview and Key Concepts sections to assume Claude's knowledge of LD, credible sets, and posterior probabilities — keep only the skill-specific thresholds and reasoning rules.
Add at least one executable example: a Python snippet showing a ToolUniverse tool call followed by pandas/scipy analysis of the returned credible-set table, to honor the 'COMPUTE, DON'T DESCRIBE' header.
Show one or two tool invocations with concrete arguments and expected output fields (e.g. OpenTargets_get_variant_credible_sets with a variant id) so Claude knows how to call and parse them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, but the Overview and Key Concepts sections re-explain LD, credible sets, posterior probability, and L2G — concepts Claude already knows — adding padding around the genuinely useful thresholds and reasoning rules. | 3 / 5 |
Actionability | Concrete tool names, query→tool mappings, and numeric decision thresholds (PP<0.5, L2G>0.7) are given, but despite the 'COMPUTE, DON'T DESCRIBE' mandate there is no executable Python example and tool calls are never shown with arguments or sample output. | 3 / 5 |
Workflow Clarity | A clear five-step reasoning framework with explicit conditional checkpoints ('If the posterior probability is < 0.5... examine other variants') and a prioritization tiebreaker checklist; this is interpretive analysis rather than a destructive/batch operation so the validation cap does not apply. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections (Overview, Reasoning Framework, Tools, Interpretation, FAQ, Limitations) with no nested references and no bundle files; the inlined FAQ and academic References could arguably be split out but inline placement is reasonable. | 4 / 5 |
Total | 14 / 20 Passed |