wave-propagation

Simulate wave propagation — acoustic, electromagnetic, elastic, and quantum waves. FDTD, spectral methods, and absorbing boundary conditions for 1D/2D/3D wave equations with sources, scattering, and dispersion.

Quality

73%

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/wave-propagation/SKILL.md

Quality

Content

72%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, code-rich skill body that gives Claude ready-to-run simulations across multiple methods, held back by monolithic inlining (no progressive disclosure to separate files) and the lack of explicit validation checkpoints in its workflows.

Suggestions

Split the four worked examples and the source-type/CFL reference tables into referenced files (e.g. references/examples.md, references/sources.md) and keep SKILL.md as a concise overview with one-level-deep links.

Add an explicit stability-validation step to the FDTD workflows (e.g. 'After running, check the CFL printout and max(|u|) is bounded; if it diverges, reduce dt per the troubleshooting table').

Trim inline matplotlib plotting boilerplate and obvious inline comments to tighten token efficiency.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean executable code with light comments and brief tables, but includes some expendable padding — inline matplotlib plotting setup and obvious comments like '# Fields: u at three time levels' or '# Interior update' — that could be trimmed.	4 / 5
Actionability	Four copy-paste-ready, fully executable Python examples (1D FDTD, 2D FDTD, pseudospectral, dispersion analysis) cover the common cases with concrete, runnable code and parameters.	5 / 5
Workflow Clarity	The numbered 'Core Workflows' are parallel alternative methods rather than a sequenced process, and while the troubleshooting table gives implicit feedback (blow-up -> reduce dt), there are no explicit validation checkpoints for confirming stability or correctness before proceeding.	3 / 5
Progressive Disclosure	Sections are well-organized (Overview, When to Use, Core Workflows, CFL, Source Types, Troubleshooting), but at ~247 lines everything is inlined in SKILL.md with no bundle files and no one-level-deep references to split out the detailed examples or reference material.	3 / 5
	Total	15 / 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 with strong capability detail and low conflict risk, weakened only by the absence of an explicit 'when to use' trigger clause and slightly technical-leaning keyword choice.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when simulating sound, light, seismic, or water waves, or analyzing scattering, resonance, and dispersion.'

Include user-friendly synonyms alongside the technical terms (e.g. 'sound' for acoustic, 'light' for electromagnetic, 'seismic' for elastic) to broaden natural-trigger coverage.

Dimension	Reasoning	Score
Specificity	Names the domain plus multiple concrete capabilities — 'FDTD, spectral methods', 'absorbing boundary conditions', 'sources, scattering, and dispersion', '1D/2D/3D wave equations' — giving comprehensive coverage of specific actions rather than vague language.	5 / 5
Completeness	The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	Good keyword coverage with natural physics terms ('wave propagation', 'acoustic', 'electromagnetic', 'elastic', 'quantum waves', 'scattering', 'dispersion'), but it leans technical and omits the everyday synonyms users might say ('sound', 'light', 'seismic').	4 / 5
Distinctiveness Conflict Risk	It occupies a clear niche (numerical wave-equation simulation with named methods) with distinct triggers, making overlap with other skills minimal.	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/wave-propagation/SKILL.md
Commit: 543b17f

Reviewed: 2 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.