Content
78%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 highly actionable with clean progressive disclosure to real reference, script, and asset files, and workflows carry explicit validation checkpoints. Its main weakness is verbosity from meta-guidance sections that restate best practices already covered elsewhere.
Suggestions
Trim or merge 'Example Interactions' and 'Handling User Requests' into the relevant workflow/reference sections to reduce token overhead.
Move the full effective-genome-size table and normalization-method list fully into their reference files, keeping only the quick-selection guide inline.
Promote one explicit validate→fix→retry loop inline (e.g. in Quick Start) to close the workflow-clarity gap toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and avoids explaining basic NGS concepts, but the 'Handling User Requests', 'Example Interactions', and 'Key Reminders' sections restate guidance already covered and inline tables (genome sizes, normalization) partly duplicate the reference files, so it could be tightened. | 3 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands throughout — 'python scripts/validate_files.py --bam ...', 'python scripts/workflow_generator.py chipseq_qc -o ...', 'uv pip install deepTools==3.5.6', 'bamCoverage --bam input.bam -o chr1.bw --region chr1' — covering the common cases. | 5 / 5 |
Workflow Clarity | Clear sequences with explicit validation checkpoints ('Always validate files first', 'Start with QC', 'Test on small regions') and a troubleshooting feedback section; the full validate→fix→retry loops live in the reference workflows rather than inline, leaving a minor gap versus the 5 anchor. | 4 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references — a '## Reference Documentation' section describes each of the 5 reference files, 2 scripts, and 1 asset with 'Use this reference when' guidance, and all cited paths resolve to real bundle files. | 5 / 5 |
Total | 17 / 20 Passed |