Content
90%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 content is lean, actionable, and well-structured with concrete executable commands and clear validation cues. Its main gap is the absence of an explicit validate→fix→retry feedback loop and the lack of progressive-disclosure reference files for the larger command/output detail.
Suggestions
Add an explicit numbered execution sequence with a validate→fix→retry loop, e.g. run preflight → review install plan → fix missing resources → re-run with --require-resource-plan before proceeding.
Move the full flag/output-manifest detail into a references/ file (e.g. SOMATIC_RUNNER.md) and link to it from the body to improve progressive disclosure.
Add a short explicit verification step confirming pairing-table correctness before --execute, with a recovery path if pairs are missing or swapped.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence—it never explains what somatic variants are or how GATK/Mutect2 works—and every section (Essential Inputs, Route, Decision Points, Outputs) earns its place without padding. | 5 / 5 |
Actionability | Provides two fully executable command blocks with concrete flags (the preflight and the Mutect2 runner) plus a concrete list of produced artifacts, covering the common tumor-normal/tumor-only cases in copy-paste-ready form. | 5 / 5 |
Workflow Clarity | A clear route exists (confirm inputs → preflight → route → run → decision points → outputs) with checkpoints like pair-metadata verification and the advisory resource check, but it is organized topically rather than as a numbered sequence with an explicit validate→fix→retry feedback loop. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the single SKILL.md is well organized with clear section headers and no nested references; it inlines some detail (full flag lists, output manifests) that could be split into reference files, leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |