Content
60%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 is highly actionable and well-structured, with verified helper scripts and a clear workflow including a verification step. Its main weakness is token efficiency: large verbatim duplication across the seaborn sections, generic library explanation, and three overlapping checklists inflate the file well beyond what the guidance earns.
Suggestions
Deduplicate the seaborn material: the boxplot/stripplot example, correlation heatmap, Okabe-Ito palette, and CI lineplot each appear twice (e.g., 'Quick Start with Seaborn' vs the seaborn tutorial section); keep one copy of each and move the full tutorial into references/ (e.g., a seaborn_examples.md alongside matplotlib_examples.md).
Remove or fix the dangling references to 'scientific-packages/seaborn/SKILL.md' and its references/ files (lines 648-651) — these paths do not exist in this bundle.
Trim content Claude already knows, such as the generic seaborn overview prose ('Seaborn provides a high-level, dataset-oriented interface...') and library-advantage bullet lists, and consolidate the three overlapping checklists (Task 5 checklist, Common Pitfalls, Final Checklist) into a single checklist section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably padded with duplication: the boxplot/stripplot example appears verbatim twice (Quick Start and the seaborn section), the correlation heatmap and Okabe-Ito palette are each repeated, and the seaborn lineplot/errorbar examples appear in both 'Common Tasks' and the seaborn tutorial. Generic library prose Claude already knows ('Seaborn provides a high-level, dataset-oriented interface for statistical graphics... It excels at...') and three overlapping checklists (Task 5, Common Pitfalls, Final Checklist) add further padding. It is more padded than the 'mostly efficient' 3 anchor but does contain substantial genuinely useful guidance, so it does not fall to 1. | 2 / 5 |
Actionability | Most guidance is executable, copy-paste-ready code whose helpers exist in the bundle (save_publication_figure, configure_for_journal, check_figure_size, apply_palette all verified in scripts/ and assets/). Minor gaps keep it below 5: many snippets reference undefined placeholders (df, timeseries, means, sems, x_jittered) rather than runnable data, matching the 'concrete code with minor gaps' anchor. | 4 / 5 |
Workflow Clarity | The Workflow Summary gives a clear sequenced process (Plan, Configure, Create, Verify with check_figure_size, Export, Review) with an explicit verification checkpoint and a final checklist. It falls short of 5 because there is no error-recovery loop telling the reader what to do when check_figure_size or the size/font checks fail — verification is present but the fix-and-retry feedback loop is only implicit in Task 5. | 4 / 5 |
Progressive Disclosure | Structure is good: a Resources section describes every reference/script/asset file, all referenced bundle paths exist and expose the documented functions, and references are one level deep. The gaps keeping it below 5 are the ~250-line inlined seaborn tutorial that duplicates body content and belongs in a reference file, plus four dangling references to 'scientific-packages/seaborn/...' paths that do not exist in this bundle. It is clearly better organized than the 'some structure' 3 anchor, so it sits at 4. | 4 / 5 |
Total | 14 / 20 Passed |