mujoco-physics-storyboardinglisted
Install: claude install-skill Yash-Kavaiya/mujoco-explainer-skills
# Physics Storyboarding for MuJoCo Explainers
A good explainer **makes one claim per shot and then proves it with the simulation on screen**.
This skill produces a storyboard YAML for `mujoco-explainer-video`.
## Process
1. **Audience and length.** Decide the audience (curious public, students, engineers) and the format: 30–60 s
short (5–7 shots), 1–3 min explainer (8–14 shots), or chapters of a lecture. Default to a
60–90 s explainer for a general audience if the user doesn't say.
2. **One-sentence takeaway.** Write it first, for example "Deterministic does not mean predictable". Every
shot must serve it.
3. **Find the visual proof.** Look the concept up in `references/concept-catalog.md`. It gives the scene,
the parameter to vary, the overlay that proves it, and pitfalls. Prefer existing
`@scenes/…`. If a concept needs a new model, write it with `mujoco-scene-authoring`.
4. **Shot list with the arc below.** Write it as a table first (shot · claim · visual · caption)
and then convert it to YAML.
5. **Write captions/narration** following the writing rules below. Add `say:` lines if narration is wanted.
6. **Render a preview, look at the contact sheet, and revise.** Typical fixes are reframing, cutting a shot that
doesn't prove anything, and slowing down fast events.
## The arc
| beat | shot type | job | duration |
|---|---|---|---|
| Hook | `title` or a striking `sim` | pose a question or show the surprise | 3–5 s |
| Setup | `bullets` | name the ide