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.
An exemplary scientific-workflow skill body: executable commands for every stage, explicit validation checkpoints and failure semantics, feedback loops for mask correction, and well-structured one-level-deep references. Its only weakness is a handful of minor trimmable explanations of general cryo-EM practice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with RELION-specific operational constraints Claude does not inherently know (one-based 'index@stack.mrcs' indices, project-relative path resolution, odd MPI ranks >= 3, the <=256^3 FSC limit, B-factor left at zero), with no padding or generic-library explanation. A few minor instances could be trimmed — 'Nyquist resolution is 2 × pixel size' and some generic inspection advice — placing it at anchor 4 rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Four fully executable, copy-paste-ready commands ('python scripts/spa_workflow.py validate-star ...', 'refine --star ... --mpi-ranks 3', 'fsc ... --output diagnostic-fsc.tsv', 'postprocess --half1 ... --mask ...') cover all subcommands with concrete flags and realistic paths. Illustrative values are explicitly justified ('The diameter and low-pass filter above are illustrative Å values. Use specimen-appropriate values'). | 5 / 5 |
Workflow Clarity | Sections follow the actual pipeline order (validate STAR → refine → inspect half maps → postprocess) matching the intro's stated sequence, with pre-flight checklists ('Before running, inspect representative particles and class averages...'), explicit validation semantics ('stops on process failure', 'requires converged unfiltered half maps before reporting success', "'null' means no downward crossing was detected"), a feedback loop ('residual correlation calls for a smoother/wider mask and another postprocessing run'), and restart guidance (use the original job's optimiser). | 5 / 5 |
Progressive Disclosure | A lean ~120-line overview with two clearly signaled, purpose-scoped references ('Read [references/acquisition-and-restarts.md] when starting from movies or resuming jobs'; 'See [references/runtime-and-validation.md] for the tested native utilities and the distinction between pipeline execution and reconstruction validation'), both verified to exist and to contain no further nested references. Detail is appropriately split out, and external primary references are listed at the end. | 5 / 5 |
Total | 19 / 20 Passed |