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.
The body is a strong example of an operational skill: fully executable commands, an explicit validate-then-run sequence with validation checkpoints and error-recovery guidance at every stage, and a clean overview-to-reference split verified against the actual bundle files. Its only weakness is minor hedging redundancy that slightly inflates token cost without adding operational value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes domain competence (never explains what QIIME 2, DADA2, or 16S are) and nearly every sentence carries operational content, but there are minor instances that could be trimmed — e.g., the 'illustrative, not universal' disclaimer appears twice and the merged-stats subcommand caveats run long. Not 5: a few hedging sentences and repeated qualifiers are padding-adjacent; not 3: there is no wholesale unnecessary explanation, and version numbers are load-bearing operational constraints rather than decorative time-sensitivity. | 4 / 5 |
Actionability | Copy-paste-ready validate and run invocations with every flag spelled out, an exact manifest header/example, the concrete overlap threshold 'trunc_f + trunc_r - maximum_insert_length >= 12', and named output artifacts (retention-qc.json, stats/stats.tsv, commands.json, workflow.log). Not 4: the examples cover the common cases completely and are executable as written, not just mostly. | 5 / 5 |
Workflow Clarity | The sequence is explicit — establish the assay, prepare inputs, 'First validate without QIIME', then run, then inspect — with feedback loops and checkpoints throughout: the runner 'stops on a failing QIIME command', runs 'maximum-level QIIME artifact validation before reporting completion', low primer-match rates are surfaced as warnings with candidate causes, and per-stage stats interpretation tells the user what to review when loss occurs. This is a batch operation with explicit validation, so no cap applies. Not 4: validation checkpoints and error-recovery guidance are explicit at every phase, not mostly present. | 5 / 5 |
Progressive Disclosure | A clear overview body (assay setup, input format, two runnable commands, result inspection) with one-level-deep, well-signaled references that both exist in the bundle: scripts/amplicon_workflow.py for the executable helper and references/runtime-and-interpretation.md for the release-pinned action contract, restart handling and interpretation — content appropriately split out of the main file. Not 4: navigation is easy and the split is clean, with no inlined bulk reference material and no buried references. | 5 / 5 |
Total | 19 / 20 Passed |