teardown

What it does

• One offline HTML page per machine — three.js and fonts inlined by sims/build.mjs, nothing to deploy
• Made to be taken apart — the machine runs in the middle, surrounding panels read the real numbers, a button opens the part doing the work
• Self-touring idle mode — untouched, the page walks through the machine on its own
• Frame-accurate film export — sims/capture.mjs renders the film to a 60 fps mp4, or to review sheets of stills
• Three complete machines included — a V8 engine, a Cessna and a Strandbeest, each as machine, drivable page and recorded film

When to use it

Any how-does-X-work question becomes a simulator, using the README's own examples: build a 4-stroke motorcycle engine you can take apart, show how a mechanical watch keeps time, or make a teardown of a hydraulic excavator arm and record a 20-second video of it. The three shipped machines double as style references — node sims/build.mjs cessna-live opens one without any prompting.

Getting started

npx skills add elvarofficial/teardown -g -a claude-code

# then, once, in the installed folder:
npm install && npx playwright install chromium

# drive one of the three shipped machines:
node sims/build.mjs v8-live

Needs Node.js 20 or newer; ffmpeg for the video, Python 3 for the sound.

Things to know

The README is deliberately short — teardown was created 2026-10-30 (349 stars as of writing) and its documentation is thinner than its output; treat the three shipped machines as the ground truth for what works. It builds on whaleyxbt/claude-motion (MIT) for the runtime, frame capture, sound engine and review rules, and its recorded samples are CC0 from Freesound, prepared by Barty-Bart/motion-graphics. Omitting -a claude-code is fine — the skills CLI otherwise just asks which agent to set up.