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.
A tightly written, highly actionable skill body: copy-paste-ready commands covering all routing options, lean checklists, and well-organized sections. The remaining gaps are modest — no explicit error-recovery loops around QC failures and no reference files for deeper material like the full runner flag set or the sample-sheet schema.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — checklist-style inputs, direct command blocks, and terse decision points with no re-teaching of concepts Claude already knows (no "what ChIP-seq is" filler). Not 4 because there is no identifiable padding to trim; every section carries actionable content. | 5 / 5 |
Actionability | Commands are fully executable and copy-paste ready with real flags, paths, and named outputs ("--peak-mode narrow", "--bowtie2-index /refs/GRCh38/bowtie2/genome", emitted "qc/chip_cutrun_qc_summary.{tsv,json}"), and the examples cover the common cases (chipseq/tf/narrow plus nf-core routes). Not 4 because the command blocks are complete rather than having minor gaps. | 5 / 5 |
Workflow Clarity | A clear sequence is present — confirm inputs, run preflight, route (nf-core vs direct MACS2 vs dedicated runner), then check QC metrics ("alignment rate, duplicate rate, fragment size, FRiP/peak signal, blacklist overlap, and replicate concordance") — and validation exists (preflight, resource readiness gating), so the batch-operation cap does not apply. Not 5 because there are no explicit error-recovery feedback loops (e.g., what to do when FRiP or replicate concordance fails); not 3 because validation checkpoints are explicitly present, not merely implied. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into Essential Inputs, Route, Decision Points, and Outputs with no nested references and no content that plainly belongs in a separate file. Not 5 because there are no well-signaled one-level-deep references for deeper material (a runner flag reference or sample-sheet schema would fit naturally in a references/ file); not 3 because structure is clean and nothing bulky is mis-inlined. | 4 / 5 |
Total | 18 / 20 Passed |