CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

neural-operator

Train neural operators (FNO, DeepONet) to learn solution maps for parametric PDE families. Once trained, solve new PDE instances in milliseconds. Use when you need to solve many instances of the same PDE with different parameters/ICs/BCs.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/physics/neural-operator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The content is highly actionable with concrete, mostly executable code and useful domain-specific tables for architecture and hyperparameter selection, but it is dragged down by inlined PyTorch/matplotlib boilerplate and a monolithic single-file structure with no progressive disclosure to reference or script files. Small fixes — removing the unused import, making the DeepONet usage runnable, and moving boilerplate to scripts — would lift it substantially.

Suggestions

Move the generic training loop, dataset-generation script, and plotting boilerplate into scripts/ files and reference them from SKILL.md, keeping only the architecture-selection and hyperparameter guidance plus a minimal quick-start inline.

Remove the unused 'from neuraloperator.datasets import load_darcy_flow_small' import from the Burgers workflow, and replace the commented-out DeepONet '# Usage' block with a runnable example.

Add an explicit validation checkpoint to the workflow (e.g., a target relative-L2 threshold to accept a trained model, with a retry loop feeding into the troubleshooting table) to strengthen the train→evaluate feedback loop.

DimensionReasoningScore

Conciseness

The body inlines substantial boilerplate Claude already knows — a full generic PyTorch training loop (Adam, batching, scheduler), standard matplotlib plotting code, and a brief overview paragraph explaining neural operators — alongside genuinely valuable domain content (the pseudospectral Burgers data generator, architecture selection table, hyperparameter ranges). This matches anchor 3: mostly efficient but with unnecessary sections that could be trimmed, rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Most code is executable and complete: dataset generation, FNO1d training, DeepONet class, and evaluation/plotting with concrete parameters. Minor gaps keep it below anchor 5: 'from neuraloperator.datasets import load_darcy_flow_small' is imported but never used (and is irrelevant to the Burgers workflow), and the DeepONet section ends in commented-out usage ('# Usage: ... # model = DeepONet(...)') rather than a runnable workflow.

4 / 5

Workflow Clarity

The numbered Core Workflows (1. generate data → 2. train → 3. architectures → 4. evaluate/visualize) give a clear sequence, with the periodic test-error/rel-L2 evaluation acting as a checkpoint and a troubleshooting table for error recovery. It falls short of anchor 5 because there is no explicit 'only proceed when rel L2 meets target' gate or validate-and-retry loop for the training workflow.

4 / 5

Progressive Disclosure

The body has clear section structure but everything is inlined in a single ~250-line SKILL.md with no bundle files — the full data-generation script, complete training loop, DeepONet implementation, and plotting code are content that would better live in scripts/ or reference files. This matches anchor 3: some structure, but content that should be separate is inline; it is not anchor 2 because headers and tables keep it navigable.

3 / 5

Total

14

/

20

Passed

Description

87%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: concrete capabilities, named architectures, third-person voice, and an explicit 'Use when' trigger clause that clearly delimits the skill's niche. Only minor gaps such as missing 'surrogate model' terminology keep trigger coverage from full marks.

DimensionReasoningScore

Specificity

The description names the domain ('parametric PDE families') and several concrete actions — 'Train neural operators (FNO, DeepONet) to learn solution maps' and 'solve new PDE instances in milliseconds' — with named architectures. It sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive coverage) because training and fast solving are covered but data generation/evaluation are absent, placing it noticeably above the midpoint.

4 / 5

Completeness

It explicitly answers both questions: what ('Train neural operators ... to learn solution maps for parametric PDE families ... solve new PDE instances in milliseconds') and when ('Use when you need to solve many instances of the same PDE with different parameters/ICs/BCs') — an explicit trigger clause with concrete phrases, matching anchor 5. Voice is third person ('Train', 'solve'), so no penalty applies.

5 / 5

Trigger Term Quality

Natural technical terms users would say are present: 'neural operators', 'FNO', 'DeepONet', 'PDE', 'solve many instances of the same PDE with different parameters/ICs/BCs'. Coverage is good but misses common synonyms like 'surrogate model' or 'physics-informed', so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — neural operators (FNO, DeepONet) for parametric PDE families — and the 'when' clause scopes it to repeated solving of the same PDE, minimizing overlap with generic solver or ML skills. This matches anchor 5 (clear niche with distinct triggers).

5 / 5

Total

18

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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/neural-operator/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.