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 high-quality instruction-only skill body: a validated phased workflow with explicit fallback loops, precise tool parameter formats, and domain-specific thresholds and interpretive guidance. The only improvements are consolidating the duplicated CADD/threshold content between the reasoning framework and the phase sections, and adding one worked end-to-end example.
Suggestions
Consolidate the deleteriousness thresholds that appear in both the Pathogenicity Reasoning Framework and Phase 3/3b into a single location to remove redundancy and tighten conciseness.
Add one worked end-to-end example (e.g., TP53 R175H from input through synthesized report) showing actual tool calls and how key result fields are extracted, closing the actionability gap.
Consider moving per-tool parameter reference detail and the report template into a references/ file to keep SKILL.md as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific value Claude cannot infer: exact parameter formats ('chrom-pos-ref-alt (hg38, no "chr" prefix)'), thresholds (CADD ≥30/≥20, gnomAD AF <0.001, REVEL ≥0.75, AlphaMissense ≥0.564), ClinVar star semantics, and the ClinGen classification ladder. Minor repetition between the Pathogenicity Reasoning Framework and the phase sections (CADD thresholds appear twice) keeps it at the score-4 anchor rather than 5. | 4 / 5 |
Actionability | Concrete, copy-paste-ready guidance throughout: exact tool signatures ('ProtVar_map_variant takes hgvs, genomic, or protein_variant'), a worked FAVOR call ('19-44908822-C-T'), exact annotator strings ('clinvar,gnomad3,sift,polyphen2,revel,alphamissense,cadd_exome'), and a full report template. As an instruction-only skill this satisfies the rubric; the minor gap is no worked end-to-end example showing a call and its parsed output, so score 4 rather than 5. | 4 / 5 |
Workflow Clarity | Phases 0–5 plus synthesis are laid out in an ASCII diagram, Phase 0 validates/normalizes input notation before proceeding, ClinGen gene-disease validity is an explicit pre-interpretation gate, and the Fallback Chains section provides per-tool error-recovery loops for every failure mode. This matches the score-5 anchor (clear sequence, validation steps, feedback loops); not a destructive or batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | A single-file skill with well-organized section headers and no broken references (no bundle files exist and the body points to none). At ~230 lines, per-tool parameter reference detail and the report template could sit in a references/ file, but there is no monolithic inline bulk. Good structure with a minor organization gap — the score-4 anchor; not 5 because the file exceeds the simple-skill threshold where sections alone would suffice. | 4 / 5 |
Total | 17 / 20 Passed |