Content
82%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 dense, command-driven skill body with executable runner and preflight invocations, explicit validation modes, and a clear routing decision between nf-core and a local path. Its weaknesses are modest: a confusing dry-run flag explanation, no explicit ordered workflow with error-recovery guidance, and reference-bundle details that would sit better in a separate file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes domain competence — no explanation of what RNA-seq, strandedness, or MultiQC are; every line carries operational content. A few dense passages could be trimmed, most notably the overlapping flag semantics ('Omit --execute for validation plus Snakemake workflow validation only. Use --no-dry-run only when...') which read as confusing rather than merely terse, keeping it below the level-5 anchor. | 4 / 5 |
Actionability | Full copy-paste-ready commands with concrete arguments: the runner invocation with --sample-sheet, --fastq-root, reference flags, and --execute, plus two preflight invocations with explicit flags. Decision points give concrete, checkable actions ('Inspect per-sample reads, mapping rate, rRNA/mitochondrial fraction...'). This matches the fully-executable, covers-common-cases anchor. | 5 / 5 |
Workflow Clarity | A coherent sequence is present — confirm essential inputs, run preflight, choose a route, run with or without --execute — with real validation checkpoints (dry-run/validation-only mode, Snakemake workflow graph validation, resource readiness checks, and a QC verdict JSON covering outlier samples). It falls short of the level-5 anchor because the sequence is organized by topic sections rather than an explicit ordered flow with feedback loops (what to do when validation or readiness fails is not stated). | 4 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview (~66 lines) with clearly delineated sections (inputs, route, decision points, outputs) and no nested or buried references — runner paths point at plugin scripts rather than bundle reference files. It misses the level-5 anchor partly because it slightly exceeds the simple-skill line, and the long Outputs/resource-bundle enumerations (resource plan, manifest, env exports, readiness summary) are exactly the kind of detail that could move one level deep into a reference file. | 4 / 5 |
Total | 17 / 20 Passed |