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 and well-structured with good progressive disclosure and explicit guardrails for risky/batch operations. The main weakness is redundancy between the Quick Start and Typical Workflows sections, which inflates the token budget without adding new information.
Suggestions
Collapse the Quick Start and Typical Workflows sections into a single set of worked examples; the count→select→select-variants-in-samples flow is currently shown twice with near-identical commands.
Consolidate 'When to Use', 'Core Rules', and 'Command Selection Guide' — the command-to-question mapping is repeated across these sections.
Add an explicit error-recovery note for the count-before-select checkpoint (e.g., what 'too large' means and what to do instead) to turn the guardrail into a full feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and command-focused, but the Quick Start and Typical Workflows sections duplicate the same count→select→select-variants-in-samples pattern, and the When-to-Use / Core Rules / Command Selection Guide overlap, adding repeatable tokens. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready bash invocations with real example coordinates (BRCA1 chr17:43044292-43170245) and sample IDs, plus complete flag lists covering the common cases. | 5 / 5 |
Workflow Clarity | Clear numbered sequencing with checkpoints (mandatory coordinate provenance, count-before-select guardrail) for batch operations, but lacks an explicit error-recovery feedback loop beyond 'only proceed if count is manageable'. | 4 / 5 |
Progressive Disclosure | Body is a well-organized overview that pushes full per-command argument tables and output schemas to references/onekgpd_commands.md and controlled vocabularies to references/annotation_vocabularies.md — one level deep, clearly signaled links, easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |