Content
75%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 well-structured, actionable, and sequenced with validation built into the workflow, leaning on a single helper entrypoint and real reference files. Minor improvements are available in deduplicating triggers, adding executor-specific examples, and annotating the reference list.
Suggestions
Remove the 'When to Use' trigger-phrase list or shrink it, since the same triggers already appear in the frontmatter description, to recover token budget.
Annotate each entry in the References section with what it contains (e.g., 'pacsomatic_guide.md — pipeline parameters and output structure') so navigation is unambiguous.
Add an explicit validate->fix->retry feedback loop in the Workflow (e.g., 'if --dry-run validation fails, report the failing constraint and re-run after correction') to strengthen the validation checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no explanation of Nextflow/BAM basics), but the 'When to Use' trigger list duplicates the frontmatter and the 'Agent Response Contract' is slightly padded, so a few tokens could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready bash commands covering dry-run and Slurm execution plus explicit routing rules and a concrete inputs list; minor gaps remain (no LSF/PBS/SGE executor examples shown), keeping it just below fully comprehensive. | 4 / 5 |
Workflow Clarity | An 8-step numbered workflow is clearly sequenced with a dry-run validation checkpoint (step 6) and triage guidance for failures, but the validate->fix->retry feedback loop is implicit rather than spelled out. | 4 / 5 |
Progressive Disclosure | Well-organized sections (Quick Start, Inputs, Workflow) with real one-level-deep references listed at the end; the references are present and valid but not annotated with what each file contains, a minor navigation gap. | 4 / 5 |
Total | 16 / 20 Passed |