sfx-designlisted
Install: claude install-skill vaibhav-barman/live-clipper
# SFX DESIGN — landing the hit, at the right level
> **THE ESSENCE:** a sound effect is scheduled by its **peak**, chosen by **what moves**, levelled for
> **the final delivered file**, and **proven** to have fired. Everything else is taste.
Adapted from the creator's skill. **Kept:** peak scheduling, sound-by-motion, the final-domain volume
formula, the measurement trap, the residual check, retiming with captions. **Changed:** no 522-file
house library — you build your own catalogue with `scripts/sfx_catalog.py`; ffmpeg replaces Remotion
(so the mix offset is re-measured); density is lower because stream audio is already busy.
## 0. Build the catalogue (once, and whenever files change)
Use only SFX you're licensed to redistribute in posts (CC0 / royalty-free packs). Then:
```bash
python3 scripts/sfx_catalog.py sfx/ > sfx/catalog.json
```
Each entry: `file`, `peak_s` (argmax offset), `peak_dbfs`, `onset_s`, `dur_s`. **Schedule from this
file, never by eye.** 3–4 variants per kind (whoosh_01…04) so the rotation doesn't repeat.
## 1. Schedule at the PEAK, not at the file start
A file's transient does not sit at its start, so scheduling at the visual event lands the hit **late**.
```
start_s = event_s − peak_s
```
Originally measured: a click peaks at ~0.5 frames, a pop at ~7 frames, a swish at ~15 frames (60 fps).
A whoosh started at the event lands a quarter-second late.
## 2. Pick the sound by what is MOVING, not by taste
| motion | sound |
|---|---|
| the frame trave