Content
85%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 is highly actionable and workflow-clear: every phase has concrete tool calls, exact thresholds, validation-first sequencing, and explicit disagreement-handling guidance. Its weaknesses are localized verbosity in the InterVar/ESM narrative passages and a monolithic single-file structure with no progressive disclosure — the tool reference, criteria details, and output template are prime candidates for separate reference files.
Suggestions
Split the 'Tool Parameter Reference' table into a references/tool-reference.md file (and the output-format template into its own reference), keeping SKILL.md to the phase workflow plus the classification algorithm, so the main file stays a lean overview with one-level-deep references.
Trim the two 'verified live' InterVar anecdote paragraphs down to their operational takeaway (re-verify tool examples live; the documented BRCA1 example's coordinates encode an SNV, not the labeled frameshift) — the current narrative form spends many tokens on context Claude doesn't need at decision time.
Compress the 'Mechanism complement for VUS-resolution narratives' paragraph to a short bullet: when a mechanistic explanation is needed for a missense VUS, call ESM_explain_variant_mechanism (requires ESM_API_KEY) to convert PP3 into an explained criterion — the extended before/after example can be cut.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is dense operational content that earns its tokens — a tool parameter table, exact thresholds ('REVEL >= 0.7', 'mis_z > 3.09', 'pLI >= 0.9 or LOEUF < 0.35'), and the full classification combination rules. However, the InterVar section carries two long anecdotal prose paragraphs ('Cross-validation example, verified live', 'Known data-quality issue, verified live, not a guess') and the ESM 'Mechanism complement' paragraph is narrative-heavy — minor instances of over-explanation that could be trimmed, matching the 4 anchor rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable guidance throughout: concrete tool calls with named parameters in every phase, precise numeric thresholds for each criterion, a copy-paste output-format template, and four worked patterns showing phase order and expected verdicts. This matches the 5 anchor (copy-paste ready commands, specific examples covering the common cases); the few '...' placeholders are input-dependent values, not pseudocode, so it is not 3 or 4. | 5 / 5 |
Workflow Clarity | Phases 0–6 are clearly sequenced with validation checkpoints and feedback loops: Phase 0 validates HGVS/transcript explicitly ('Wrong HGVS or wrong transcript cascades errors through every downstream criterion. Validate first.'), Phase 1 handles missing data ('note the gap and continue'), Phase 2 defines discordance handling, and the InterVar cross-check section prescribes what to do on disagreement ('treat it as a reason to re-examine your manual criteria'). This matches the 5 anchor's explicit validation plus error-recovery loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), so the entire skill is one ~230-line monolith: the tool parameter reference, full 28-criteria guidance, classification algorithm, and output template are all inlined. Section headers give it reasonable structure, but content that clearly belongs in one-level-deep reference files is inline and there are no references at all — matching the 3 anchor ('content that should be separate is inline') rather than 4, since 4 assumes references exist and are mostly clear. | 3 / 5 |
Total | 17 / 20 Passed |