Content
42%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 contains valuable skill-specific guidance (honesty rule, tool inventory, compute-don't-describe) but is diluted by extensive textbook GWAS meta-analysis explanation, high-level rather than executable workflows, and a reference to a non-existent bundle file.
Suggestions
Move textbook material (I² formula, fixed/random-effects explanations, quality tiers, sources of heterogeneity) into a separate reference file and keep SKILL.md focused on skill-specific procedure and tool usage.
Replace the high-level workflow bullets with concrete, executable sequences that name the exact tool calls per step and show a short Python example for the meta-analysis computation.
Either add the referenced python_implementation.py to the scripts/ bundle or remove the inline reference to it, so referenced paths resolve to real files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: large sections (Statistical Methods, Study Quality Assessment, Limitations) restate textbook GWAS concepts Claude already knows — I² formula, fixed/random effects, quality tiers, winner's curse, publication bias — adding significant padding. | 2 / 5 |
Actionability | Concrete tool names (gwas_search_studies, gwas_get_associations_for_snp) and a "COMPUTE, DON'T DESCRIBE" directive help, but workflows are high-level bullets with no executable code, and the referenced python_implementation.py is described rather than shown. | 3 / 5 |
Workflow Clarity | Use-case workflows list sequenced steps with stated outcomes, but validation checkpoints are implicit; only the honesty rule acts as a guardrail, and steps lack concrete tool calls per step. | 3 / 5 |
Progressive Disclosure | Headers give reasonable structure, but the body inlines textbook material that belongs in reference files and references python_implementation.py, which is not present in the (empty) references/scripts/assets bundle. | 3 / 5 |
Total | 11 / 20 Passed |