Content
46%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 content pairs genuinely actionable reference material (parameter table, sample data, executable examples) with heavy generic process boilerplate and broken cross-references. Bundle paths are advertised but absent, and navigation cues point to later sections, weakening structure.
Suggestions
Trim duplicated compile/help checks and remove generic boilerplate (Response Template, Output Requirements, Validation rules) that Claude already knows; keep only forest-plot-specific guidance.
Fix the backward "See ## Features/Usage/Workflow above" pointers and remove or create the referenced bundle files (references/, scripts/main.py, requirements.txt).
Add a concrete validation checkpoint in the Workflow tied to the plotting output (e.g. confirm the PNG/PDF is generated and opens, check the pooled-effect diamond and reference line render).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose: duplicated compile/help checks across Quick Check, Audit-Ready Commands, Usage, and Examples, plus generic process boilerplate (Output Requirements, Response Template, Input Validation, Validation and Safety Rules) that Claude already knows. It is above a 1 because concrete executable content is mixed in, but the padding and repetition keep it below a 3. | 2 / 5 |
Actionability | Executable guidance is strong: a full parameter table with defaults and required flags, an input-column table, a sample CSV, and copy-paste invocations covering basic, custom-style, subgroup, and PDF output. It is not a 5 because one audit example passes prose text to --input (contradicting the CSV/Excel requirement) and a few flags are only loosely specified. | 4 / 5 |
Workflow Clarity | A 5-step Workflow with a fallback step is present, but the steps are generic ("confirm objective", "validate scope") rather than tied to the plotting operation, and there is no executable validation checkpoint on the generated artifact (e.g. verify the output file opens). The checkpoints are implicit, matching the anchor for a 3. | 3 / 5 |
Progressive Disclosure | The body references bundle paths (scripts/main.py, references/, requirements.txt) that do not exist on disk, and navigation is broken ("See ## Features above", "See ## Usage above", "See ## Workflow above" point to sections appearing later). Reference-style content (preset styles, parameter docs) is inlined rather than split out, matching the anchor for minimal structure with buried/non-resolving references. | 2 / 5 |
Total | 11 / 20 Passed |