mujoco-scene-authoringlisted
Install: claude install-skill Yash-Kavaiya/mujoco-explainer-skills
# MuJoCo Scene Authoring (camera-ready MJCF)
The goal is a model that is **physically honest** (it demonstrates the concept for the right reason)
and **telegenic** (high contrast, readable at 720p, nothing important hidden).
## Workflow
1. Start from `assets/template.xml`, which has the shared look (skybox, grid floor, key and fill
lights, palette materials `cyan pink gold mint violet steel dark`, and a `front` camera).
2. Build the mechanism. Name everything a storyboard will reference: bodies, joints, **sites at
points of interest** (tips, end-effectors) and actuators. Add a `<keyframe name="start">` for the
interesting initial state.
3. Validate and look at it:
```bash
python scripts/validate_scene.py my_scene.xml --seconds 5 # prints names, stability, drift
```
Open the generated `my_scene_preview.png` and fix anything that is too small, too dark,
clipping the floor, or intersecting.
4. Iterate until you get `OK`. Then reference it from a storyboard (`scene: my_scene.xml`).
## Design rules
**Scale and framing**
- Work in metres and kilograms with real-world sizes, so gravity reads correctly.
- Keep the action within roughly a 3 m cube around the origin, above the floor (z > 0).
- Put the camera so the subject fills 40–70% of frame height. In `front` cameras, `xyaxes="1 0 0 0 0.1 1"`
looks along +y with a slight downward tilt.
**Looks**
- Use contrasting palette materials for parts that must be told apart; use `dark`/`steel` for scaff