physics-visualization

Publication-quality physics plots — vector fields, streamlines, contour maps, 3D surfaces, phase space, spectrograms, and animations. Optimized for journal submission with LaTeX labels, proper colormaps, and multi-panel layouts.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/physics/physics-visualization/SKILL.md

Quality

Content

78%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 highly actionable, well-organized catalog of publication-quality physics plot recipes with copy-paste code, but it is a monolithic single file with no progressive disclosure pointing to deeper reference materials, and the Overview lightly duplicates the description.

Suggestions

Split per-plot-type recipes and the colormap/save-format tables into reference files (e.g. PLOT_TYPES.md, COLORMAPS.md) and point to them from SKILL.md to improve progressive disclosure.

Trim the Overview to avoid restating the frontmatter description, keeping only what aids orientation.

Add a short runnable example that actually uses the multi_panel helper, so every provided function has a complete usage demonstration.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean, executable code with minimal prose and no padding about what matplotlib/numpy are; minor over-explanation comes from the Overview restating the frontmatter and a few obvious inline comments.	4 / 5
Actionability	Every plot type ships complete, copy-paste-ready Python with imports, sample data, plotting, and savefig calls, covering the common physics-plot cases.	5 / 5
Workflow Clarity	Each example is a self-contained setup-to-save flow and no destructive/batch operation requires validation checkpoints, so the per-task sequence is clear with only minor implicit-flow gaps across the catalog.	4 / 5
Progressive Disclosure	It is a single ~244-line file that inlines all six code examples and reference tables with no external bundle files and no signaled references, so content that could be split into per-type reference files is monolithically inlined.	3 / 5
	Total	16 / 20 Passed

Description

75%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 specific, well-scoped description that names concrete physics plot types and formatting features, but it omits an explicit 'Use when...' trigger clause, which caps its completeness and leaves trigger guidance only implied.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when generating physics figures for journals, papers, or reports involving fields, potentials, phase space, or wavefunctions.'

Include a few more natural synonyms/broadener terms (e.g. 'figures', 'publication figures', 'heatmaps') to improve trigger-term coverage.

Optionally note file formats users mention (e.g. PDF/PNG output) to strengthen trigger recognition.

Dimension	Reasoning	Score
Specificity	The description enumerates multiple concrete plot types ("vector fields, streamlines, contour maps, 3D surfaces, phase space, spectrograms, and animations") plus formatting specifics ("LaTeX labels, proper colormaps, and multi-panel layouts"), giving comprehensive coverage of the domain's outputs.	5 / 5
Completeness	It clearly states what the skill does but lacks an explicit "Use when..." trigger clause, so per the guideline a missing explicit trigger caps completeness at 3.	3 / 5
Trigger Term Quality	It includes natural terms users request ("physics plots", "vector fields", "streamlines", "phase space", "spectrograms") but misses common synonyms and broader phrases like "figures", "publication figures", or "heatmaps" that anchor-5 coverage would include.	4 / 5
Distinctiveness Conflict Risk	The physics-publication niche with distinctive triggers (phase space, spectrograms, vector fields) is clearly separable from generic plotting skills, giving minimal conflict risk.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: synthetic-sciences/openscience
Path: backend/cli/skills/physics/physics-visualization/SKILL.md
Commit: 1d182e9

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.