Content
71%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 a knowledgeable, well-sequenced domain guide with genuinely executable code and unusually good error-recovery guidance. Its main weaknesses are broken progressive disclosure — five referenced bundle files that do not exist, with the ACMG algorithm inlined anyway — and minor over-explanation in the regulatory and conflicting-evidence sections.
Suggestions
Ship the five referenced bundle files (or remove the references): no references/ directory exists, so ACMG_CLASSIFICATION.md, CODE_PATTERNS.md, CHECKLIST.md, EXAMPLES.md, and TOOLS_REFERENCE.md all fail to resolve, breaking both navigation and the pre-delivery verification step.
Move the Bayesian point table, the full classify_acmg implementation, and the gene-specific BS1 thresholds out of Phase 6 into ACMG_CLASSIFICATION.md — the body already directs readers there 'for the complete algorithm', so keep only the classification cutoffs and evidence-code summary inline.
Tighten Phase 2.5's prediction rationale and the 'Handling Conflicting Evidence' narrative into short rule-style guidance, and inline the calling signatures for Phases 4-5 tools (or ensure TOOLS_REFERENCE.md exists with them).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious domain content (ToolUniverse tool parameters, gnomAD two-step workflow, fallback chains) that Claude cannot know, so it earns its tokens. But Phase 2.5's mechanism rationale paragraph ('annotation says an element is present, not whether this specific allele disrupts it...') and the discursive 'Handling Conflicting Evidence' narrative include explanation that could be tightened to direct tool-selection rules. This matches 'efficient; minor instances of over-explanation that could be trimmed', not the lean anchor at 5. | 4 / 5 |
Actionability | Strong concrete guidance: copy-paste-ready `classify_acmg` and `ESM_explain_variant_mechanism` code, parameter tables for regulatory-prediction tools, and explicit fallback orderings. Falls short of fully executable because Phases 4 and 5 list bare tool names with the parameter details deferred to `TOOLS_REFERENCE.md`, which is not present in the bundle, and many tool invocations (e.g. `ClinVar_search_variants`) never show their calling signature. | 4 / 5 |
Workflow Clarity | A clearly sequenced 6-phase pipeline (with 2.5/2.9/4.2/4.5 sub-phases), feedback loops via the 'Tool Failure Fallbacks' section, and checkpoints via 'Quantified Minimums' and a short-circuit ClinVar check. Minor validation gaps remain: the pre-delivery verification checklist is delegated to `CHECKLIST.md` which is absent, and per-phase 'capture/verify before proceeding' checkpoints are implicit. Anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'), not 5, since the explicit validation checklist does not resolve. | 4 / 5 |
Progressive Disclosure | The References section signals five one-level-deep files with one-line descriptions (good pattern), but no bundle files exist — `ACMG_CLASSIFICATION.md`, `CODE_PATTERNS.md`, `CHECKLIST.md`, `EXAMPLES.md`, and `TOOLS_REFERENCE.md` are all missing from the skill directory, so every reference is a dead end. Additionally, ~100 lines of Phase 6 (Bayesian point table, full `classify_acmg` implementation, gene-specific BS1 thresholds) inline the very content the body says lives in `ACMG_CLASSIFICATION.md` ('See ACMG_CLASSIFICATION.md for the complete algorithm'), which is the 'content that should be separate is inline' pattern of anchor 3. | 3 / 5 |
Total | 15 / 20 Passed |