Content
81%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 with explicit validation steps, error recovery, and clean reference signaling. The main defects are the dangling tests/ paths used in the example commands and minor redundancy in the Workflow and Testing sections.
Suggestions
Fix the dangling tests/ references: either bundle tests/data/oa_exp.csv, tests/data/oa_group.csv, and tests/run_tests.R, or rewrite the Usage and Testing examples to use a generic user-supplied input path.
Trim the Workflow section's narration of internal script internals (e.g., 'compute empirical Bayes moderated statistics'), which duplicates references/algorithm.md, and keep only the steps Claude must orchestrate.
Deduplicate the Testing section's smoke-test command, which repeats the Usage example verbatim — one example command is sufficient.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by terse tables and bullets with no concept padding, but the Workflow section narrates internal script steps Claude does not perform ('compute empirical Bayes moderated statistics') and the Testing smoke-test command duplicates the Usage example. Minor trimmable content keeps it just below the lean anchor. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: a full CLI invocation, an Arguments table with types and defaults, Output Files and Error Handling tables. However, the example commands reference 'tests/data/oa_exp.csv', 'tests/data/oa_group.csv', and 'tests/run_tests.R', which do not exist in the bundle, so the commands are not copy-paste ready as shipped. | 4 / 5 |
Workflow Clarity | Step 1 is explicit input validation (file existence, non-empty matrix, sample ID overlap, minimum two samples per group), the Error Handling table maps every SKILL_* code to a fix, and the Testing section lists expected outputs and edge cases (empty DEG.csv, skipped heatmap). Sequence, checkpoints, and recovery loops are all present. | 5 / 5 |
Progressive Disclosure | The 'When to Read External Files' table clearly signals one-level-deep references, and references/algorithm.md, references/cli-guide.md, references/troubleshooting.md, and scripts/main.R all exist. But the table and Usage section also point to tests/data/ and tests/run_tests.R, which are absent from the bundle — a dangling reference preventing a top score. | 4 / 5 |
Total | 17 / 20 Passed |