Content
56%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 delivers strong executable guidance with a verified, coherent bundle (scripts, style files, and reference docs all exist and match what the text claims) and a clear workflow with checklists. Its main weaknesses are heavy redundancy — the seaborn material is duplicated verbatim and generic library explanation pads the file — and a large inline seaborn section that both belongs in a reference file and points to non-existent scientific-packages/ paths.
Suggestions
Deduplicate repeated code blocks: the seaborn boxplot/stripplot example, correlation heatmap, Okabe-Ito palette listing, and set_theme/despine guidance each appear twice; keep one copy and point to references/matplotlib_examples.md for the rest.
Move the ~250-line seaborn deep-dive (advantages, plot-type gallery, axes- vs figure-level functions, advanced techniques) into a references/seaborn_examples.md file, keeping only a brief quick-start inline.
Fix or remove the four dangling references to scientific-packages/seaborn/SKILL.md and its references/*.md files (lines 648-651), which do not exist in this bundle; replace them with the bundle's actual reference files or with instructions on how to apply the documented principles to seaborn.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At 781 lines the body is noticeably verbose with pervasive verbatim duplication: the seaborn boxplot/stripplot block appears twice, the correlation-heatmap block twice, the Okabe-Ito palette list twice, and set_theme/despine guidance is repeated across multiple sections. It also explains concepts Claude already knows ('Seaborn provides a high-level, dataset-oriented interface for statistical graphics, built on matplotlib' plus generic library advantages), matching anchor 2 rather than the occasional over-explanation of anchor 3. | 2 / 5 |
Actionability | Provides extensive concrete code, and the claimed helpers were verified to exist (save_publication_figure/save_for_journal/check_figure_size in scripts/figure_export.py, apply_publication_style/configure_for_journal in scripts/style_presets.py, OKABE_ITO_LIST/apply_palette in assets/color_palettes.py). Minor gaps keep it below anchor 5: many snippets use undefined variables (df, timeseries, x_jittered, datasets) and script imports assume path setup, so they are not fully copy-paste ready. | 4 / 5 |
Workflow Clarity | The Workflow Summary gives a clear sequenced process (Plan, Configure, Create, Verify, Export, Review) with inline commands, an explicit Verify step (check_figure_size), a fix-an-existing-figure checklist (Task 5), and a Final Checklist. It lacks an error-recovery feedback loop (no guidance on what to do when a check fails), which is the anchor-5 requirement, so it sits at anchor 4; no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the four references/, two scripts/, and four assets/ files are real, listed, and described in the Resources section, one level deep. However, the ~250-line seaborn section inlines content that belongs in a reference file, and it cites scientific-packages/seaborn/SKILL.md plus three of its reference files (lines 648-651) that do not exist in the bundle — dangling references. This matches anchor 3 ('content that should be separate is inline') rather than the well-split structure of anchor 4. | 3 / 5 |
Total | 13 / 20 Passed |