Content
88%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.
A well-structured, highly actionable body: complete CLI reference with executable examples, explicit mode sequencing with pre-flight validation, error-recovery feedback loops, and clearly signaled one-level-deep references. The only real weaknesses are repeated restatements of the scope exclusion and dangling references to a tests/ directory that is not bundled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven with no tutorials on concepts Claude already knows; every argument, output, and error row earns its place. The one trimmable pattern is the scope exclusion ("does not infer networks from expression matrices" / "Use a different workflow") restated across "When to Use", "Out-of-Scope Response Pattern", and "Scope Limits" — minor over-explanation per anchor 4 rather than the lean-every-token-counts of anchor 5. | 4 / 5 |
Actionability | Copy-paste-ready Rscript commands appear in Usage, four Examples, and Testing; the Arguments table lists every flag with type, default, and legal values; input formats and error codes come with concrete solutions. This fully matches the anchor for executable, common-case-covering guidance. | 5 / 5 |
Workflow Clarity | The Execution Model sequences the analyze/visualize/full modes with an explicit pre-flight check ("Before --mode visualize, confirm that output_dir/data/lncrna_network.rda already exists") and failure-mode handling; the Error Handling table provides fix-and-rerun feedback loops, and Result Size Guidance plus Testing (with expected retained outputs) close the loop. Not anchor 4 because no meaningful validation checkpoint is missing. | 5 / 5 |
Progressive Disclosure | The "When to Read External Files" table clearly signals one-level-deep references (algorithm.md, troubleshooting.md, cli-guide.md, scripts/main.R), all of which exist in the bundle. However, the body also references tests/data/ and tests/run_tests.R, which are absent from the bundle — a minor organization gap that keeps it at anchor 4 (good structure, minor gaps) rather than the clean navigation of anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |