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-structured orchestrator skill: executable commands for both upstream paths, a clearly sequenced stage workflow with validation checkpoints and QC feedback loops, and clean progressive disclosure to verified reference files and scripts. The only minor weakness is occasional restatement of domain knowledge that Claude already has.
Suggestions
Tighten the 'Common Pitfalls' and stage descriptions by trimming domain restatements Claude already knows (e.g. 'DESeq2 needs raw counts', why strandedness halves reads) and keeping only the skill-specific decision guidance.
Consider moving the full Path B inline commands into references/upstream-manual.md (already referenced) and leaving only the canonical one-liner per stage in SKILL.md to further reduce token load.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — it delegates depth to references, links sibling skills rather than re-explaining them, and uses compact tables and a Mermaid diagram — but a few sentences restate domain knowledge Claude already has (e.g. elaborating why strandedness matters, restating 'DESeq2 needs raw counts') that could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready commands for both paths (validated samplesheet check, nf-core run with pinned -r, fastp/salmon invocations, the build_counts_matrix.py bridge call) and points to executable bundled scripts, covering the common cases concretely. | 5 / 5 |
Workflow Clarity | The 8-stage numbered workflow is clearly sequenced with an explicit validation checkpoint (validate_samplesheet.py before the run), a smoke-test step, QC gates framed as feedback loops ('re-run FastQC to confirm', 'always look at the PCA before trusting DE'), and a Common Pitfalls section guiding error recovery — matching the explicit-validation anchor. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview that routes to four real one-level-deep reference files (all present under references/) and two real scripts (present under scripts/), each self-contained and clearly signaled by name in the body and a dedicated Reference Files section; no nested-reference chains. | 5 / 5 |
Total | 19 / 20 Passed |