# 3d Chladni Render

Clone or update https://github.com/nolangz/3D-Chladni and export deterministic 3D...

- Repository: https://github.com/vibe-motion/skills (1498 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-10-05
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add vibe-motion/skills --skill 3d-chladni-render -g -a claude-code -y`
Codex: `npx skills add vibe-motion/skills --skill 3d-chladni-render -g -a codex -y`
Cursor: `npx skills add vibe-motion/skills --skill 3d-chladni-render -g -a cursor -y`
Gemini CLI: `npx skills add vibe-motion/skills --skill 3d-chladni-render -g -a gemini-cli -y`

## Description

Clone or update https://github.com/nolangz/3D-Chladni and export deterministic 3D Chladni particle motion as MP4 or transparent ProRes MOV. Use when users ask for 3D 克拉尼, 克拉尼粒子动画, Chladni motion, sound-reactive sand or cosmic-web visuals, audio-to-motion, music visualizer video, or rendering Dynamic Sand, Modal Sand, Cosmic Web, or Dynamic Cosmic.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

```bash
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:

```bash
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:

```bash
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"
```

The rest: https://github.com/vibe-motion/skills/blob/HEAD/3d-chladni-render/SKILL.md