Content
71%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 concrete scripts, clear gotchas, and a well-sequenced workflow, but it suffers from significant duplicated sections and several broken references to bundle files that are not present.
Suggestions
De-duplicate the AE-severity, per-gene ANOVA, and R-vs-Python spline sections — keep one canonical location and cross-reference it instead of repeating verbatim.
Fix or remove dead references: anova_and_tests.md and common_patterns_summary.md are cited repeatedly but absent from references/, and QUICK_START.md/EXAMPLES.md/TOOLS_REFERENCE.md/test_skill.py in the File Structure block do not exist.
Move the detailed reasoning-framework and evidence-grading material into a reference file to reduce the inlined body length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but padded: the AE-severity 'no AEPT filter' guidance, the per-gene ANOVA aggregation rules, and the R-vs-Python spline warning each appear nearly verbatim twice (once in 'CRITICAL' and again in 'Analysis conventions'), which is unnecessary duplication. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready bash commands with concrete flags, wrong/right code examples, and Python snippets that cover the common recurring question patterns. | 5 / 5 |
Workflow Clarity | A clear RULE ZERO -> PRIMARY SCRIPTS -> Phase 0-3 sequence with a completeness checklist and a workspace-isolation guard (scripts refuse to write into the input dir), though explicit validate->fix->retry feedback loops are not strongly emphasized. | 4 / 5 |
Progressive Disclosure | References are mostly one-level-deep and clearly signaled, but several referenced files do not exist in the bundle (anova_and_tests.md, common_patterns_summary.md, QUICK_START.md, EXAMPLES.md, TOOLS_REFERENCE.md), and the 660-line body inlines substantial material that could live in the reference files. | 3 / 5 |
Total | 15 / 20 Passed |