3D Chladni Render

Workflow

1. Resolve the requested workspace, output path, duration, dimensions, and visual mode.
2. Use cosmic when the user does not choose a mode.
3. Pass an audio file with --audio when the user wants sound-reactive motion. Prefer sand or dcosmic for audio-driven output.
4. Resolve the installed skill directory and run scripts/render_3d_chladni.py.
5. Wait for the script to print VALIDATION=PASS and OUTPUT_VIDEO=<absolute path>.
6. Return the absolute output path and the render settings.

Quick Start

python3 scripts/render_3d_chladni.py \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

Installed Skill Resolution

Use the installed skill copy, not a source checkout of this skill collection:

skill_dir=""
for base in "${AGENTS_HOME:-$HOME/.agents}" "${CLAUDE_HOME:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}"; do
  if [ -d "$base/skills/3d-chladni-render" ]; then
    skill_dir="$base/skills/3d-chladni-render"
    break
  fi
done
[ -n "$skill_dir" ] || { echo "3d-chladni-render skill not found under ~/.agents, ~/.claude, or ~/.codex"; exit 1; }

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --output "$(pwd)/out/3d-chladni-cosmic.mp4"

Modes

--style	Visual mode	Best use
sand	Dynamic Sand	Audio-reactive inertial sand motion
msand	Modal Sand	Stable sculptural Chladni nodes
cosmic	Cosmic Web	Calm rotating three-dimensional particle web
dcosmic	Dynamic Cosmic	Audio-reactive cosmic deformation

Audio-Driven Render

Use an absolute path for the user's audio file:

python3 "$skill_dir/scripts/render_3d_chladni.py" \
  --workspace "$(pwd)" \
  --style dcosmic \
  --audio "/absolute/path/to/music.wav" \
  --seconds 12 \
  --output "$(pwd)/out/audio-chladni.mp4"