Content
62%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 actionable with executable commands and concrete data-format tables, and has a clear workflow with a validation checkpoint. It is somewhat verbose with generic boilerplate sections and has minor progressive-disclosure gaps from mixed Python/R execution paths.
Suggestions
Remove or condense generic boilerplate sections (When to Use, Key Features, Required Inputs, Output Contract, Validation and Safety Rules) that restate what Claude already knows.
Reconcile the execution path: the body alternates between running python scripts/funnel_plot.py and Rscript scripts/funnel_plot.R; make the intended entry point and the role of each script explicit.
Add an explicit error-recovery feedback loop for the common failure cases (missing R packages, CSV column mismatches) so validation->fix->retry is concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete tables and commands, but includes several generic filler sections (When to Use, Key Features, Required Inputs, Output Contract, Validation and Safety Rules) that restate obvious guidance Claude already knows and could be tightened. | 3 / 5 |
Actionability | Provides an executable Rscript invocation with parameter descriptions, concrete CSV column tables per data type, and a quick-validation command; minor gaps such as the example-run-plan and inline CONFIG editing being only sketched keep it from a 5. | 4 / 5 |
Workflow Clarity | A clear 3-step sequence (validate input -> execute R script -> output results) with an explicit validation checkpoint (at least 3 studies required) and failure-handling guidance; not a 5 because error-recovery feedback loops for script/R-package failures are described generically rather than as explicit validate->fix->retry cycles. | 4 / 5 |
Progressive Disclosure | Content is reasonably sectioned and references real bundle scripts (scripts/funnel_plot.py, scripts/funnel_plot.R), but there is a cross-language inconsistency (Python helper vs R execution path) and a stray 'See ## Workflow above' pointer, and inline details that belong with the scripts are not clearly signaled as one-level-deep references. | 3 / 5 |
Total | 14 / 20 Passed |