Content
78%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.
An action-dense, highly executable reference: complete runnable code for every advertised plot type, terse prose, and useful decision tables. Its weaknesses are structural — all detail lives inline in SKILL.md with no reference files, and the recommended workflow (setup → choose type → save) is never stated explicitly.
Suggestions
Split the six worked examples into references/ files (e.g. references/vector-fields.md, references/animations.md) and keep one minimal snippet per type in SKILL.md, turning the body into an overview with well-signaled one-level-deep references.
State the intended sequence explicitly at the top of "Core Plot Types" (e.g. "Run the Setup block first; it is required by all examples below").
Replace the ineffective LaTeX try/except with a real pre-flight check (e.g. test-render a small figure or detect a TeX installation) so the "fallback to mathtext" path is an actual feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-forward with almost no padding — it never explains concepts Claude already knows (no "matplotlib is a plotting library" prose) and comments are terse and purposeful ("# non-interactive backend for scripts", "# Dipole at (±0.5, 0)"). Minor trimming is possible (e.g. the "Enable LaTeX if available" try/except block, and full worked examples could be slightly leaner), so it sits just below the lean-and-efficient anchor. | 4 / 5 |
Actionability | Every section provides complete, copy-paste-ready executable code: the Setup rcParams block, six fully-worked plotting functions/examples ("def plot_vector_field...", the dipole field example, the FuncAnimation wave example), and concrete save commands ("plt.savefig('figure.png', dpi=300, bbox_inches='tight')"). The examples cover the common cases for each plot type with no pseudocode. | 5 / 5 |
Workflow Clarity | The implied sequence is clear and unambiguous — apply the Setup defaults, pick the plot type from "Core Plot Types", follow the Colormap Guide, then the Save Format Guide — and no destructive/batch operations exist so no validation checkpoint cap applies. It falls short of anchor 5 because the sequencing is implicit rather than stated (there is no explicit "include the Setup block before using any plot function" instruction) and the LaTeX-fallback check ("try: ... except: pass") gives no real feedback loop. | 4 / 5 |
Progressive Disclosure | The section structure itself is clean and navigable, but the file is a single monolithic ~250-line document with no bundle files (no references/, scripts/, or assets/ exist) and no pointers to detailed material — all six complete worked examples plus the colormap and save-format guides are inlined where per-plot-type detail naturally belongs in one-level-deep reference files, matching the "content that should be separate is inline" anchor. | 3 / 5 |
Total | 16 / 20 Passed |