4.4 KiB
cutaway
A Claude Code skill that turns one picture into a 3D object that takes itself apart.
Give Claude an image of a robotic animal, a machine or a device. It rebuilds it in three.js, every shell, gear and fang written as code, checks the build against the picture line by line, and films it: a cursor presses a button, that part comes apart under its own camera, then the whole object explodes and snaps back together.
Install
npx skills add Nyxera0x/cutaway -g -a claude-code
Then, once, in the installed folder:
npm install && npx playwright install chromium
You need Node.js 20 or newer. For the video you also need ffmpeg, and for the sound Python 3.
Use
Give Claude Code a picture and ask in plain words:
Here is a robotic mantis. Build it as a 3D object I can take apart, and stop at the still so I can check it.
Turn this image of a robot crab into a 20-second film where every part comes apart.
I approved the still. Film it the way the piranha example is filmed.
No picture yet? docs/PROMPTS.md has the prompt that generated ours.
Or open one of the 4 examples first:
node sims/build.mjs tarantula-film # cutaway-out/dist/tarantula-film.html
node sims/build.mjs piranha-film
node sims/build.mjs wasp-film
node sims/build.mjs cigar-film
The whole road in one call
node film.mjs --setup # once: installs deps, a browser and ffmpeg where missing
node film.mjs wasp-film --gif # build -> score -> capture -> mux -> beat sheet -> waveform -> gif
film.mjs prints the GPU it captured on, the score's loudness, and every artifact path. --quick renders a fast draft; flags mirror sims/capture.mjs. If the Playwright Chromium download is unavailable, it captures in the installed Edge or Chrome (same WebGL) and finds ffmpeg even when it is only in winget's Links dir.
How it works
- One reference picture sets the look. Claude reads it and rebuilds it; it never imports it.
- A checklist for that picture: 10 to 12 numbered lines Claude grades yes, partial or no every round.
- Measured, not eyeballed: the share of dark mechanism and the proportions, both against the picture.
- A still first. Claude stops after round 2 and waits for your yes. Nothing gets filmed before it.
- The film reuses the example with the closest body 1:1 and changes the body only. Every part gets its own camera.
- A 10-second version gets its own script, its own opening and its own exit.
The whole method is in docs/, written so you can follow it with or without the code.
What is inside
SKILL.md |
What Claude reads: the order of work, the rules that make it look right, the review loop. |
docs/JOB_DESCRIPTION.md |
The brief Claude reads before every object. Your corrections go into it. |
docs/CHECKLIST.md, docs/PROMPTS.md, docs/LESSONS.md |
The checklist format with a full example, every prompt, every mistake and the line it added. |
sims/tarantula-*, sims/piranha-*, sims/wasp-*, sims/cigar-* |
4 complete objects. -shared is the object, -film the full film, -demo the 10-second version (the three robots). |
sims/green/ |
The page around every object and the green look, plus 3 review tools: leftover-colour probe, camera track, part anchors. |
sims/kit/ |
Runtime, stage, shader warm-up. |
sims/build.mjs |
Bundles an object into one HTML file, three.js and fonts inlined. |
sims/capture.mjs |
Renders the film frame by frame to a 60 fps mp4, or to review sheets of stills. |
sfx/, run_sfx.py |
Procedural sound on the film's timeline, mastered to −14 LUFS. |
Credits
Built on whaleyxbt/claude-motion (MIT): the runtime, frame capture, sound engine and review rules come from there. Recorded samples are CC0 from Freesound, prepared by Barty-Bart/motion-graphics; sources in sfx/samples/SOURCES.md.
MIT licence.



