CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hamiltonian-mechanics

Hamiltonian mechanics — symplectic integrators (leapfrog, Yoshida), Hamilton's equations, Poisson brackets, canonical transformations, action-angle variables, and KAM theory analysis. Use for energy-conserving long-time integration of conservative systems.

68

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 code-first, highly executable skill body: every workflow is runnable as written and decision guidance (when/when-not, method comparison, troubleshooting) is concise. The main gaps are moderate — plotting boilerplate inflates token cost, and the two secondary workflows belong in reference files to keep the main file lean.

Suggestions

Move the N-body and Poincaré-section workflows into references/ (e.g. references/nbody.md, references/poincare.md) and keep SKILL.md to a lean overview with well-signaled links.

Trim matplotlib cosmetics (axis labels, grids, legends) from the inline example to just the orbit plot and energy trace.

Add an explicit post-run validation step to each workflow (e.g. 'verify max |ΔH/H₀| < tolerance; if it drifts, halve dt or switch to Yoshida') to turn the troubleshooting table into in-workflow feedback loops.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no space is spent explaining what Hamiltonians or NumPy are, and the prose is limited to decision guidance (When to Use / Do NOT Use, comparison table). The only trimming candidate is matplotlib boilerplate (xlabel/ylabel/grid/legend lines) in the Kepler example, which is cosmetic rather than skill-relevant, matching the 'minor instances of over-explanation' anchor rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

All four workflows are complete, executable, copy-paste-ready NumPy code: the leapfrog implementation includes working Kepler initial conditions, a printed energy-conservation check, and Yoshida coefficients spelled out. The examples cover the common cases (2D Kepler, 3-body figure-8, Poincaré section), fully matching the 'copy-paste ready code covering common cases' anchor.

5 / 5

Workflow Clarity

The four core workflows are numbered and self-contained, with an embedded checkpoint (the energy-drift check in workflow 1) and a symptom→fix Troubleshooting table providing error-recovery guidance. Validation checkpoints are not woven into workflows 2–4 and the document presents parallel alternatives rather than one validated sequence, so it matches 'clear sequence with most checkpoints present; minor validation gaps' rather than the full feedback-loop anchor. No cap applies since the operations are non-destructive.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything is inline in one file. Structure is good — clear section headers, comparison tables, a troubleshooting table — but roughly 150 lines of code with secondary workflows (N-body, Poincaré section) inlined in SKILL.md would fit the disclosure model better as one-level-deep reference files. This matches 'good structure; most content appropriately placed; minor organization gaps' rather than a lean overview with well-signaled references.

4 / 5

Total

17

/

20

Passed

Description

83%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, specific description with an explicit use-when clause and low conflict risk. Its main weakness is trigger coverage: natural user phrases like N-body, molecular dynamics, and energy drift are omitted in favor of narrower technical triggers.

Suggestions

Extend the 'Use for' clause with concrete user-facing triggers, e.g. 'N-body or celestial mechanics simulations, molecular dynamics, or any case where RK45 energy drift is unacceptable'.

Add natural synonyms or problem phrasings users actually say — 'energy drift', 'long-time orbit integration', 'molecular dynamics' — to improve retrieval.

State the action in third-person imperative verb form (e.g. 'Integrates conservative systems with symplectic methods') rather than leading with a bare domain label.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'symplectic integrators (leapfrog, Yoshida)', 'Poisson brackets', 'canonical transformations', 'action-angle variables', 'KAM theory analysis' — with comprehensive coverage of the skill's domain. No vague filler; each phrase names a distinct action.

5 / 5

Completeness

Both parts are present: a clear 'what' (the enumerated capability list) and an explicit 'when' ('Use for energy-conserving long-time integration of conservative systems'). The 'when' clause is a single, somewhat technical trigger rather than multiple concrete user-mention phrases, so it sits between the explicit-but-could-be-more-specific anchor 4 and the fully concrete anchor 5.

4 / 5

Trigger Term Quality

Good domain keywords ('Hamiltonian', 'symplectic', 'leapfrog', 'energy-conserving', 'conservative systems'), but common user phrasings the body itself identifies — 'N-body', 'celestial mechanics', 'molecular dynamics', 'energy drift' — are absent. Coverage is solid with a few natural synonyms missing, matching anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Hamiltonian/symplectic mechanics with named integrators — that would not plausibly fire for a generic ODE or plotting skill; the body even contrasts itself against standard 'ode-solver' usage. Minimal conflict risk.

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/hamiltonian-mechanics/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.