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 highly actionable, well-sequenced classification workflow with concrete tool calls, thresholds, validation checkpoints, and worked patterns. Its weaknesses are mild: some rationale prose that could be trimmed and a monolithic single-file layout where reference splitting would help.
Suggestions
Compress the InterVar data-quality narrative to its operational warning (documented example is wrong; re-verify live and pass your own encoded variant), cutting roughly a paragraph of backstory.
Move the 18-row Tool Parameter Reference and per-criterion threshold detail into a single references/ file (one level deep, linked from the body) to shrink the always-loaded SKILL.md.
Trim the 'ACMG Reasoning' section to only the skill-specific guidance (combination emphasis, the two common errors), dropping the generic PVS1 > PS > PM > PP hierarchy recap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational content — tool parameter tables, hard thresholds (REVEL >= 0.7, mis_z > 3.09, pLI >= 0.9), combination rules, and an output template — with almost no filler. Minor over-explanation remains: the 'ACMG Reasoning' section restates guideline hierarchy Claude largely knows, and the two-paragraph InterVar verified-live narrative (documented worked example vs. live API result) could be compressed to its operational warning. | 4 / 5 |
Actionability | Fully executable guidance throughout: concrete tool calls with parameters (e.g. VariantValidator_validate_variant(variant_description=..., genome_build="GRCh38", select_transcripts="mane_select")), explicit numeric cutoffs per criterion, a complete classification decision algorithm, a copy-ready output report template, and four worked end-to-end patterns with concrete variants and results. | 5 / 5 |
Workflow Clarity | Phases 0–6 are clearly sequenced with explicit validation: Phase 0 validates/normalizes the variant before any evidence gathering ('Wrong HGVS or wrong transcript cascades errors... Validate first'), BA1 provides a documented short-circuit, and the InterVar cross-check acts as a terminal validation with a defined feedback loop ('if they disagree, treat it as a reason to re-examine your manual criteria'). Common Patterns show complete flows with final verdicts. | 5 / 5 |
Progressive Disclosure | The single SKILL.md is well-sectioned (Tool Parameter Reference, Phases 0–6, algorithm, output format, patterns) and easy to navigate, with no nested-reference problem since no bundle files exist. However, at ~250 lines everything is inline — the 18-row tool table and per-criterion detail could be split into one-level references — so it stops short of the well-signaled split structure of the top anchor. | 4 / 5 |
Total | 18 / 20 Passed |