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 strong, well-engineered skill body: executable pinned commands for both upstream paths, an explicitly validated 8-stage workflow with QC feedback loops, and clean one-level-deep progressive disclosure to real bundle files. The only meaningful cost is modest verbosity in the citation/provenance prose and slight duplication between the path-selection table and its follow-up paragraph.
Suggestions
Trim the "Citing Scientific Agent Skills" section to a single short line plus the reference string, moving the fetching/version-resolution rules to a reference file.
Consolidate the two-paths decision table and the paragraph after it ("When unsure, prefer Path A...") into one place to remove the duplicated rationale.
Move the tool-version provenance paragraph ("Reviewed against nf-core/rnaseq 3.27.0...") into a compact "Validation status" or provenance subsection so time-sensitive detail is quarantined from the operational sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly assumes Claude's competence — no explanations of what RNA-seq or the tools are — but a few sections could be trimmed: the ~15-line "Citing Scientific Agent Skills" block, the prose provenance paragraph ("Reviewed against nf-core/rnaseq 3.27.0, STAR 2.7.11b...") which is time-sensitive detail not placed in a deprecated/old-patterns section, and mild duplication between the two-paths table and the paragraph following it. Not a 5: these padding instances exist; not a 3: the bulk of the ~220 lines carry unique operational value. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: pinned installs ("uv pip install \"pytximport==0.13.0\"...", a pinned conda create), exact nextflow invocations with flags ("nextflow run nf-core/rnaseq -r 3.27.0 -profile test,docker --outdir test_results"), per-step shell commands for fastqc/fastp/salmon, and bridge invocations with argument names ("python scripts/build_counts_matrix.py --from salmon --quant-dir quant/ --tx2gene tx2gene.tsv --output-dir counts/"). Concrete file outputs are named for each stage. Not a 4: the common cases (both paths, counts-to-DE handoff) are all covered with runnable commands. | 5 / 5 |
Workflow Clarity | The 8-stage numbered workflow is clearly sequenced with explicit validation checkpoints and feedback loops: "0. Validate the samplesheet first (catches the most common failures early)", a smoke-test profile before the real run, "Re-run FastQC to confirm" after trimming, "verify the assigned-reads fraction", and "Always look at the PCA and sample-distance heatmap before trusting DE". A 9-item pitfalls section serves as an error checklist. Not a 4: validation is present at every stage boundary (design, raw QC, post-trim, post-quant, pre-DE), not just most. | 5 / 5 |
Progressive Disclosure | Clear overview structure with well-signaled, one-level-deep references: all four referenced files (upstream-nfcore.md, upstream-manual.md, counts-and-handoff.md, design-and-qc.md) and both scripts (validate_samplesheet.py, build_counts_matrix.py) exist in the bundle, are cited with purpose statements at point of use, and are summarized in a "Reference Files" section noting each is self-contained. Reference-file cross-links are to siblings, not nested chains. Not a 4: the split is appropriate — overview and quick start inline, depth consistently delegated with explicit topic descriptions. | 5 / 5 |
Total | 19 / 20 Passed |