Content
86%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, highly actionable skill body that keeps the SKILL.md as an overview while delegating depth to real reference files. It would tighten slightly by trimming background prose that restates general computing concepts.
Suggestions
Trim the 'Key ideas' bullets and Overview sentences that re-explain dataflow programming and write-once-run-anywhere — Nextflow-specific framing is useful, but the general concepts can be assumed.
Add an explicit failure/feedback loop for the 'debug a failed/-resume run' path (e.g., inspect `nextflow log`, identify the failed task, fix, re-run with `-resume`) to lift workflow clarity.
The 'Citing Scientific Agent Skills' section adds context-window cost unrelated to the user's task; consider moving citation guidance into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, high-value command tables and executable examples, but a few overview passages ('dominant in bioinformatics', re-explaining dataflow programming and write-once-run-anywhere) restate concepts Claude largely already knows. | 4 / 5 |
Actionability | Copy-paste-ready `nextflow run` commands with pinned revisions and profiles, a complete runnable SAYHELLO pipeline, and full real CLI/nf-core tools command tables covering the common cases. | 5 / 5 |
Workflow Clarity | A mode-routing decision table, numbered Quick Start steps, and the 'Always test first' verification checkpoint give a clear sequence; failure-recovery validation is mentioned but not fully sequenced into a feedback loop. | 4 / 5 |
Progressive Disclosure | A clear overview routes to seven confirmed one-level-deep reference files, each named with a one-line description and surfaced through the 'Two Modes of Work' and 'Reference Files' sections. | 5 / 5 |
Total | 18 / 20 Passed |