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 strong, highly actionable knowledge skill: the biobank panel table, exact tool signatures, interpretation matrix, and report template give Claude everything needed to execute a cross-ancestry PheWAS end-to-end. The only slack is modest verbosity in the worked example and inline placement of content that could be offloaded to reference files.
Suggestions
Move the worked example (rs7903146/TCF7L2) and the BioBank Japan catalogue note into a references/ file (e.g. references/examples.md), keeping a one-line pointer in SKILL.md, to tighten progressive disclosure and the token budget.
Trim caveats that appear in both the interpretation table and the Limitations section (e.g. power/allele-frequency and build notes) to a single canonical statement with cross-reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious operational detail (the FinnGen rsID exception, BBJ's GRCh37 build, the `pval: 0.0` underflow trap) and doesn't pad with concepts Claude already knows. It falls at level 4 rather than 5 because the ~200-word worked-example paragraph and some caveats repeated across the interpretation table and Limitations could be trimmed without losing operational value. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready calls with exact parameters (`UKBTOPMed_phewas_by_variant(rsid="rs7903146", max_pval=5e-8, limit=25)`, `Genebass_gene_burden_phewas(gene="PCSK9", burden_set="pLoF", max_pval=2.5e-6, limit=25)`), the required FinnGen `chr:pos:ref:alt` format with an example, and a fill-in report template. The worked example covers both common cases (variant-level and gene-burden). | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with a decision point at Step 1 (variant-level vs gene-level), an interpretation table that functions as a checklist, and explicit verification loops such as "verify the ref/alt allele each biobank reported before interpreting" and "check `af` and `num_cases` before concluding biology". These feedback loops match the level-5 anchor; the operations are read-only lookups so no destructive-operation cap applies. | 5 / 5 |
Progressive Disclosure | The file is well-sectioned with clean header navigation and no nested references, but it is ~96 lines with the worked example and the BBJ catalogue note inlined where they could live in a separate reference file. This matches the level-4 anchor (good structure, minor organization gaps); the level-5 anchor requires well-signaled one-level-deep references or a lean under-50-line overview. | 4 / 5 |
Total | 18 / 20 Passed |