Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured orchestration skill with executable commands, real referenced bundle files, clear sequencing, and a validation gate. The main weakness is verbosity — content overlaps across the Overview, Pipeline-at-a-glance, and Stage-by-Stage sections and the pitfall list is exhaustive.
Suggestions
Collapse the overlapping stage descriptions between 'The Pipeline at a Glance', 'Stage-by-Stage Workflow', and the bridge section into a single canonical sequence to cut repeated tokens.
Trim the nine-item Common Pitfalls list to the highest-impact items (replicates, confounded batch, strandedness, non-integer/TPM counts) and move the rest into references/design-and-qc.md.
Tighten the 'Defensible' framing in the Overview — the three-bullet definition largely restates practices already enforced later in the workflow stages.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes domain competence (no beginner explanations of RNA-seq concepts), but the body runs long — the full nine-item pitfall list, repeated stage descriptions across Overview/Pipeline/Stage-by-Stage, and the 'defensible' framing add tokens that a competent model largely already knows. | 2 / 3 |
Actionability | Provides copy-paste-ready commands for both paths (nf-core run invocations, fastp/salmon one-liners, conda env, bridge script invocations) plus exact output file paths and column selections; scripts referenced are real and runnable. | 3 / 3 |
Workflow Clarity | The stage-by-stage workflow is a clear numbered sequence with an explicit validation checkpoint (validate_samplesheet.py before compute) and QC gates invoked before, during, and after quantification, matching the feedback-loop pattern for batch operations. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview that one-level-deep references four self-contained reference files and two scripts, all of which exist on disk; each reference is clearly signaled with its scope and there is no nested/deep chaining. | 3 / 3 |
Total | 11 / 12 Passed |