wave-physics

Apply validated wave physics principles to simulation code in src/waves/ and src/simulation/.

2|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/joshribakoff/surfsim --skill wave-physics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wave-physics
Source: https://github.com/joshribakoff/surfsim/tree/main/.claude/skills/wave-physics
Command: npx skills add https://github.com/joshribakoff/surfsim --skill wave-physics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate and apply core wave-physics concepts to simulation code to ensure realistic behavior and testability.

Core Features & Use Cases

  • Aligns deep vs shallow water dynamics (orbital vs elliptical motion) and shoaling with code conventions.
  • Guides foam generation, energy dissipation, and breaking criteria validation in src/waves/ and src/simulation/.
  • Provides quick references to plans and reference materials for deeper validation.

Quick Start

Review the wave-physics principles and apply them to edits in src/waves/ or src/simulation/ that affect wave behavior.

Frequently Asked Questions about wave-physics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply wave physics concepts to simulation code for accurate energy propagation?

To apply wave physics to simulation code, edit files under src/waves/ or src/simulation/ to align deep and shallow water dynamics, ensuring accurate energy propagation and orbital motion. Compliance with principles in plans/00-principles.md is required.

What is shoaling and how does it affect wave simulation behavior?

Shoaling in wave simulation governs the transition of deep water orbital motion to elliptical shallow water motion. This Skill validates shoaling dynamics against reference materials to ensure realistic energy propagation and motion as depth decreases.

How do I validate breaking criteria and foam generation in a wave simulation?

Validate breaking criteria and foam generation by applying this Skill's physics rules to your src/waves/ and src/simulation/ code. It guides energy dissipation and foam physics validation using reference materials in plans/reference/reference-wave-physics.md.

Does this wave physics validation approach work for both deep and shallow water dynamics?

Yes, this wave physics validation handles both deep and shallow water dynamics. It aligns deep water orbital motion with shallow water elliptical motion, ensuring accurate energy propagation and realistic behavior across varying depths.

What's the best way to ensure testability when implementing wave physics in simulations?

The best way to ensure testability is applying validated wave physics concepts to your src/waves/ and src/simulation/ code. This aligns motion dynamics and energy dissipation with documented principles in plans/00-principles.md for consistent behavior.