Repolode
Submit
elvarofficial

elvarofficial/teardown

A Claude Code skill that builds an interactive, offline 3D simulator of any machine you can take apart, as a single HTML page.

View on GitHub
Stars
2,534
Forks
387
Open issues
0
Last commit
7 days ago

What is it?

teardown is a Claude Code skill for explaining how a machine works. Given a request such as a motorcycle engine or a mechanical watch, Claude generates the machine as a 3D scene packaged into one offline HTML page. The machine runs in the middle of the view, surrounding panels display its real computed numbers, and a button isolates the part doing the work.

When the page is left alone it plays a built-in tour of the machine. The repository also includes a capture tool that renders that tour frame by frame into a 60 fps mp4 video, or into review sheets of still images, and a procedural sound system that mixes audio onto the film's timeline.

The repo ships three complete example machines: a V8 four-stroke engine, a Cessna 337 main landing gear, and a Strandbeest SB-10 walking mechanism. Installation uses npx skills add, followed by a one-time npm install and Playwright Chromium setup. Node.js 20 or newer is required, and ffmpeg and Python 3 are needed for video and sound.

Key features

  • 01Generates a machine as an interactive 3D scene in one offline HTML file.
  • 02Surrounding panels show live computed values from the simulation.
  • 03A button isolates the part doing the work for focused inspection.
  • 04Plays an automatic guided tour when the page is left idle.
  • 05Renders the tour to a 60 fps mp4 or to review sheets of stills.
  • 06Adds procedural sound mastered to -14 LUFS on the film timeline.

Use cases

  • Explaining how an engine, mechanism or watch works to students or colleagues.
  • Producing a short animated walkthrough video of a mechanical design.
  • Creating an offline, shareable interactive diagram of a machine.

Quick start

  1. 1

    Install the skill with npx

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

    In the installed folder, install dependencies and Chromium

    npm install && npx playwright install chromium
  3. 3

    Build an example simulator (opens as one HTML page)

    node sims/build.mjs v8-live

Things to know

  • Requires Node.js 20 or newer and Claude Code to generate new simulators.
  • Video output also needs ffmpeg, and sound generation needs Python 3.

In collections

Claude Code tools, skills & pluginsAI agent skill librariesLearning & education toolsDiagrams, charts & animated visualizations

Topics

#claude-code#agent-skill#3d-simulation#visualization#education#threejs#animation

FAQ

What is teardown?
A Claude Code skill that builds an interactive, offline 3D simulator of any machine you can take apart, as a single HTML page. teardown is a Claude Code skill for explaining how a machine works. Given a request such as a motorcycle engine or a mechanical watch, Claude generates the machine as a 3D scene packaged into one offline HTML page. The machine runs in the middle of the view, surrounding panels display its real computed numbers, and a button isolates the part doing the work.
Is teardown free to use? What license does it have?
teardown is open source under the MIT license. Check the license terms before using it in commercial products.
Is teardown still maintained?
Actively maintained. The last commit to teardown was on Oct 31, 2026.
What can I use teardown for?
Explaining how an engine, mechanism or watch works to students or colleagues. Producing a short animated walkthrough video of a mechanical design. Creating an offline, shareable interactive diagram of a machine.
How do I install teardown?
Install the skill with npx: npx skills add elvarofficial/teardown -g -a claude-code In the installed folder, install dependencies and Chromium: npm install && npx playwright install chromium Build an example simulator (opens as one HTML page): node sims/build.mjs v8-live
Where can I get teardown?
The source code and installation instructions are on GitHub: https://github.com/elvarofficial/teardown

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects