CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

matplotlib

Creates and customizes scientific plots with Matplotlib. Used for fine-grained control over plot elements, novel plot types, and scientific workflows. Export to PNG/PDF/SVG for publication. For quick statistical plots use seaborn; for interactive plots use plotly; for publication-ready multi-panel figures with journal styling, use scientific-visualization.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/matplotlib/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable reference skill whose real value lies in version-specific caveats, scientific-plotting checks, and verified one-level-deep bundle references. Its main weakness is token weight: several sections re-teach baseline matplotlib knowledge Claude already has, and the export-validation guidance, while present, is scattered rather than sequenced as an explicit workflow.

Suggestions

Trim or pointer-ify sections that restate knowledge Claude already has — "The Matplotlib Hierarchy", "Two Interfaces", the basic plot-type one-liners, and "Integration with Other Tools" — keeping the body focused on the 3.11-specific changes and caveats that genuinely add value.

Consolidate the scattered export guidance into one ordered workflow (create → save with fig.savefig → inspect the exported file → fix and re-export) so the validation feedback loop is explicit rather than distributed across sections.

Reduce "Additional Resources" and the basic styling/rcParams listings to a few lines or move them into references/styling_guide.md to reclaim token budget.

DimensionReasoningScore

Conciseness

Much of the body is dense, non-obvious curation (3.11 API changes, layout-engine interactions, savefig caveats, scientific checks), but sections like "The Matplotlib Hierarchy", "Two Interfaces" with trivial examples, the basic plot-type one-liners, "Integration with Other Tools", and "Additional Resources" restate knowledge Claude already has. Mostly efficient, but a meaningful amount of tutorial-level explanation could be trimmed or pushed to references.

3 / 5

Actionability

Concrete, executable guidance throughout: copy-paste install commands ("uv add \"matplotlib==3.11.2\" numpy scipy") and runnable script invocations ("MPLBACKEND=Agg uv run --isolated ... scripts/plot_template.py --no-show --output plot.png"), plus specific API calls with parameter explanations. Not a 5 because most code fragments use undefined named data (x, y, X, Y, Z, data); this is honestly disclosed ("Fragment examples assume imports and named data; adapt and validate them before use") but still leaves a minor gap versus copy-paste-ready.

4 / 5

Workflow Clarity

The setup → create → save → inspect sequence is present with explicit checkpoints: "Inspect the actual exported file at its final size for clipped labels, missing glyphs, contrast, and readable legends", "Save with fig.savefig before show, then plt.close(fig) in batch loops", and "adapt and validate them before use". Not a 5 because this guidance is distributed across topic sections rather than presented as one explicit ordered procedure with feedback loops, so the sequence must be assembled by the reader.

4 / 5

Progressive Disclosure

The body is an overview with clearly signaled, one-level-deep references that all exist in the bundle: inline pointers ("For comprehensive plot type examples and variations, refer to `references/plot_types.md`"; "For detailed styling options and colormap guidelines, see `references/styling_guide.md`"), a consolidated "Detailed References" section listing all four reference files, and documented usage commands for both bundled scripts. Content is appropriately split and easy to navigate.

5 / 5

Total

16

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that answers both what and when, names concrete capabilities and export formats, and does excellent routing work against sibling visualization skills. The main gaps are missing natural synonyms (chart, graph, figure) and a when-clause phrased as abstract contexts rather than concrete user triggers.

Suggestions

Add natural synonyms users actually say — "chart", "graph", "figure", "data visualization" — alongside "plots" to widen trigger coverage.

Rephrase the when-clause with concrete user-mention triggers (e.g., "Use when the user mentions matplotlib, fine-grained plot customization, or exporting publication figures") instead of abstract contexts like "scientific workflows".

DimensionReasoningScore

Specificity

Lists several concrete actions — "Creates and customizes scientific plots", "fine-grained control over plot elements", "Export to PNG/PDF/SVG for publication" — with only minor gaps. Not a 5 because phrases like "novel plot types" and "scientific workflows" are abstract, and capabilities the body covers (multi-panel layouts, animations, 3D) are unmentioned.

4 / 5

Completeness

Both parts are present: a clear what ("Creates and customizes scientific plots with Matplotlib... Export to PNG/PDF/SVG for publication") and an explicit when ("Used for fine-grained control over plot elements, novel plot types, and scientific workflows") sharpened by routing to seaborn/plotly/scientific-visualization. Not a 5 because the when-clause states abstract usage contexts rather than concrete user-mention trigger phrases like "use when the user mentions matplotlib charts or plot customization".

4 / 5

Trigger Term Quality

Good natural keyword coverage: "Matplotlib", "scientific plots", "PNG/PDF/SVG", plus adjacent tool names (seaborn, plotly) that users actually say. Not a 5 because common synonyms like "chart", "graph", "figure", or "data visualization" are missing, so some natural user phrasings would not match.

4 / 5

Distinctiveness Conflict Risk

Clear niche with minimal conflict risk: the description explicitly disambiguates against the three nearest alternatives ("For quick statistical plots use seaborn; for interactive plots use plotly; for publication-ready multi-panel figures with journal styling, use scientific-visualization") while staking out "fine-grained control over plot elements" for Matplotlib.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

K-Dense-AI/scientific-agent-skills

Path

skills/matplotlib/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.