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 dense, well-structured operational skill: concrete tool signatures, thresholds, fallback chains per phase, and a clear report template. Minor improvements possible: trim the pedagogical synthesis paragraph and generic boilerplate sections, and add complete example invocations for the ProtVar/ClinVar/ClinGen tools to match the one fully-worked FAVOR example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is high-value, non-obvious operational content (parameter formats like 'chrom-pos-ref-alt' hg38 without 'chr' prefix, CADD PHRED thresholds, REVEL ≥ 0.75, ClinVar star ratings, annotator strings), but minor padding exists: the pedagogical 'Synthesizing the four dimensions' paragraph re-explains reasoning Claude can derive, and the 'LOOK UP, DON'T GUESS' / 'COMPUTE, DON'T DESCRIBE' sections are generic boilerplate. Fits the 4 anchor ('efficient; minor instances of over-explanation that could be trimmed'), not 3, since the padding is incidental rather than pervasive. | 4 / 5 |
Actionability | Concrete executable guidance throughout: exact tool names with parameter signatures ('ProtVar_map_variant takes hgvs, genomic, or protein_variant', 'gnomad_get_variant takes variant_id in the format chrom-pos-ref-alt'), specific annotator lists ('clinvar,gnomad3,sift,polyphen2,revel,alphamissense,cadd_exome'), and one complete example call ('FAVOR_annotate_variant(variant="19-44908822-C-T")'). Falls short of the 5 anchor because only FAVOR is given as a full copy-paste invocation — ProtVar, ClinVar, and ClinGen calls lack complete example invocations with arguments. | 4 / 5 |
Workflow Clarity | A clearly sequenced Phase 0→5 pipeline with a workflow diagram, an explicit Phase-0 normalization checkpoint ('Resolve to canonical HGVS... confirm gene/transcript'), per-phase fallback chains as error-recovery loops ('ProtVar_map_variant fails → try with genomic notation', 'ClinVar unavailable → OpenCRAVAT clinvar annotator'), and a report template mandating a Data Gaps section. This matches the 5 anchor (clear sequence, feedback loops, structured checklist-like report); it exceeds 4 because failure handling is explicit for every phase rather than partially present. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so all ~230 lines are inline, but the body is cleanly sectioned (framework, key principles, phases, fallbacks, limitations) with appropriate operational density for a single file. The conceptual 'Pathogenicity Reasoning Framework' could arguably move to a reference file, which keeps this at the 4 anchor ('most content is appropriately placed; minor organization gaps') rather than 5 (which expects well-signaled one-level-deep references); it is above 3 because nothing is buried or duplicated. | 4 / 5 |
Total | 17 / 20 Passed |