Content
75%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 lean, expert-oriented body that gets straight to commands, inputs, decision points, and outputs with no filler. The main gaps are the unspecified sample-sheet schema, some duplication between Route and Outputs descriptions, and the absence of an explicit error-recovery path around the preflight/evidence-contract checks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with zero concept explanations (fgbio/samtools/bcftools are named without preamble), assuming Claude's competence. Not a 5 because there is redundancy: the postrun-summary and molecular-evidence-contract outputs are described in prose in the Route section and then re-listed in Outputs, which could be merged. | 4 / 5 |
Actionability | Two concrete, copy-paste-ready bash commands with real flags (--umi-mode duplex, --umi-tag RX, --execute) anchor the Route section. Not a 5 because the required input formats are never specified — the sample-sheet TSV columns are unstated and the "lab-validated panel workflow" branch gives no executable path. | 4 / 5 |
Workflow Clarity | The sequence Confirm inputs → Preflight (--emit-install-plan) → Run → Postrun QC review is clear, and the preflight plus the postrun summary ("missing metrics stay explicit in the notes column") act as validation checkpoints. Not a 5 because there is no explicit fix-and-retry loop (e.g. what to do when preflight fails or a sample fails the evidence contract), and decision points are not tied into the step sequence. | 4 / 5 |
Progressive Disclosure | A single-file skill with well-organized, clearly headed sections (Essential Inputs, Route, Decision Points, Outputs) and no monolithic bulk that belongs in a separate file — this matches the simple-skill pattern. Not a 5 because the body references scripts at "plugins/ngs-analysis/scripts/..." that are not present in the bundle, leaving navigation slightly ambiguous about what ships with the skill. | 4 / 5 |
Total | 16 / 20 Passed |