Content
78%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, expert-level instruction body with excellent token efficiency, concrete tool calls, and a clearly sequenced multi-phase workflow with fallback chains. Its main defects are missing mid-workflow validation checkpoints and a 'Reference Files' section where three of the four listed files are absent from the bundle, undermining the progressive-disclosure structure.
Suggestions
Ship the three referenced files (DIAGNOSTIC_WORKFLOW.md, REPORT_TEMPLATE.md, CHECKLIST.md) in the bundle or remove/inline those references — currently only scripts/clinical_patterns.py exists, so the Reference Files section contains three dangling links.
Add explicit validation checkpoints between phases, e.g., 'confirm each symptom resolved to a valid HPO term before Phase 2' and 'verify MARRVEL_get_gene resolved all IDs before gene-panel scoring'.
Include one complete end-to-end example (exact tool calls in order for a sample phenotype) either inline or in the workflow reference file, so the most common path is fully executable without improvisation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and information-dense: terse tables for parameter corrections, evidence tiers, and fallback chains; no space spent explaining what HPO, OMIM, or ACMG are; every section carries skill-specific values (scoring tiers, frequency thresholds, tool quirks). It matches the level-5 'lean and efficient; assumes Claude's competence' anchor, with only a one-line intro that loosely restates the frontmatter — not enough to drop to level 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Highly concrete guidance: exact call signatures like 'Orphanet_search_diseases(operation="search_diseases", query=keyword)', 'FAVOR_annotate_variant("chr-pos-ref-alt") (GRCh38)', a WRONG/CORRECT parameter table, numeric scoring tiers, and ACMG criteria mappings. It sits at level 4 rather than 5 because several tools (HPO_search_terms, CELLxGENE, GTEx) are named without call syntax, and the promised 'code examples and algorithms per phase' are deferred to the DIAGNOSTIC_WORKFLOW.md reference rather than shown — leaving minor gaps in copy-paste readiness. | 4 / 5 |
Workflow Clarity | The Phase 0–7 sequence is explicit and well-ordered, with key phase details, evidence-grading gates, and fallback chains that function as error-recovery loops (primary → fallback 1 → fallback 2). It falls short of the level-5 anchor because explicit mid-workflow validation checkpoints are missing — e.g., no step to verify HPO term conversion output before disease matching, or to confirm MARRVEL ID resolution before gene scoring — though this diagnostic (read-only) skill avoids the destructive/batch cap. | 4 / 5 |
Progressive Disclosure | The in-body structure is good with a clearly signaled 'Reference Files' section, but scoring against the actual bundle reveals that three of the four referenced files — DIAGNOSTIC_WORKFLOW.md, REPORT_TEMPLATE.md, and CHECKLIST.md — do not exist anywhere in the bundle (only scripts/clinical_patterns.py is present). Dangling references break navigation and leave the promised detailed material absent, which fits level 3 ('references present but' the organization is undermined) better than level 4's 'references mostly clear; minor organization gaps' — the gap here is missing files, not just organization. | 3 / 5 |
Total | 16 / 20 Passed |