Content
92%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 well-architected skill body: executable commands for both upstream paths and the bridge, a validated numbered workflow with QC checkpoints, and clean one-level-deep progressive disclosure into self-contained references. The only weakness is minor non-essential prose (the framing block and citing boilerplate) that keeps conciseness just short of perfectly lean.
Suggestions
Tighten the 'Defensible' overview block — the three-bullet Reproducible/Quality-gated/Statistically-sound expansion restates values already enforced throughout the stages; a single sentence would preserve the framing while trimming tokens.
Move the boilerplate 'Citing Scientific Agent Skills' section into a shared references file so it does not consume SKILL.md context on every load.
A couple of placeholder arguments in Path B (salmon_index, s1_R1.fq.gz) could carry a one-line note that they are per-sample placeholders, to remove any ambiguity for direct copy-paste.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it does not explain what RNA-seq, alignment, or FastQC are — but the 'Defensible' framing block and the required citing boilerplate add some tokens that could be trimmed, so it sits at efficient-with-minor-over-explanation rather than perfectly lean. | 4 / 5 |
Actionability | Provides copy-paste-ready commands covering both paths and the bridge — 'nextflow run nf-core/rnaseq -r 3.26.0 ... --aligner star_salmon', 'salmon quant -i salmon_index -l A ... --gcBias --seqBias', 'python scripts/build_counts_matrix.py --from salmon --quant-dir quant/ --tx2gene tx2gene.tsv --output-dir counts/' — matching the score-5 anchor for fully executable, common-case coverage. | 5 / 5 |
Workflow Clarity | A numbered stage-by-stage sequence with explicit validation checkpoints — 'Validate the samplesheet first (catches the most common failures early)', 'Re-run FastQC to confirm', 'Always look at the PCA and sample-distance heatmap before trusting DE' — plus a pitfalls checklist; validation is present so the batch-operation cap at 3 does not apply. | 5 / 5 |
Progressive Disclosure | A clear overview in SKILL.md pointing to four well-signaled, verified one-level-deep references (references/upstream-nfcore.md, upstream-manual.md, counts-and-handoff.md, design-and-qc.md) and two scripts, with depth appropriately split out and each reference self-contained — matching the score-5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |