teardown README

README проекта с github.com/elvarofficial/teardown. Одним файлом markdown: README.md.

teardown

A Claude Code skill that turns any machine into a 3D simulator you can take apart.

Ask how something works. Claude builds it as one offline HTML page: the machine runs in the middle, every panel around it reads the real numbers, a button opens the part doing the work, and when nobody touches it the page tours itself.

Mellis HB-7 robotic bee simulator

Telson SC-8 robotic scorpion Pelagos OC-8 robotic octopus
Telson SC-8 robotic scorpion Pelagos OC-8 robotic octopus

Install

npx skills add elvarofficial/teardown -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

Ask Claude Code in plain words:

Build me a simulator of a 4-stroke motorcycle engine I can take apart.

How does a mechanical watch keep time? Show me as a simulator.

Make a teardown of a hydraulic excavator arm and record a 20-second video of it.

Or open one of the 3 examples first:

node sims/build.mjs v8-live          # teardown-out/dist/v8-live.html
node sims/build.mjs cessna-live
node sims/build.mjs strandbeest-live

What is inside

SKILL.md What Claude reads: how a machine is built, the rules that make it look right, the review loop.
sims/kit/ Runtime, stage, shader warm-up.
sims/v8-*, sims/cessna-*, sims/strandbeest-* 3 complete machines. -shared is the machine, -live the page you drive, -film the recorded tour.
sims/build.mjs Bundles a machine 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.

teardown (elvarofficial/teardown)

Ищем в базе…

Что это такое?Скилл для Claude Code, который превращает любую описанную вами машину в интерактивный 3D-симулятор: это одна офлайн HTML-страница, где машина работает в центре, окружающие панели показывают настоящие цифры, а кнопка открывает деталь, которая в данный момент выполняет работу.
Это отдельное приложение-симулятор или то, что Claude Code создаёт для меня?Это скилл для Claude Code, а не отдельное приложение. SKILL.md учит Claude создавать симулятор машины, а Claude генерирует HTML-страницу для вас, когда вы об этом попросите.
Как использовать это с Claude Code?Установите скилл один раз в папке проекта, а затем просто попросите Claude Code простыми словами собрать симулятор, например: «Построй мне симулятор четырёхтактного мотоциклетного двигателя, который можно разобрать».
Что нужно установить, чтобы этим пользоваться?Для сборки страниц симулятора требуется Node.js 20 или новее. Для создания видео дополнительно нужен ffmpeg, а для процедурного звука — Python 3.
Нужны ли ffmpeg и Python для каждого симулятора?Нет, для основного офлайн HTML-симулятора нужен только Node.js; ffmpeg и Python требуются лишь для необязательных функций записи видео и процедурного звука.
Что на самом деле делает созданная страница симулятора?Машина работает в центре, а окружающие панели показывают настоящие цифры; кнопка открывает деталь, которая сейчас выполняет работу, а если страницу не трогать, она сама автоматически проводит экскурсию.
Какие примеры машин включены сразу?В папке sims/ есть три готовые машины: V8-двигатель, самолёт Cessna и шагающий механизм Strandbeest. Каждая разбита на общую геометрию, живую интерактивную страницу и записанный видеотур.
На чём это основано?Это основано на whaleyxbt/claude-motion (лицензия MIT), который предоставляет среду выполнения, захват кадров, звуковой движок и правила проверки; three.js и шрифты встроены прямо в итоговый HTML-файл.
Можно ли превратить симуляцию в видео?Да, capture.mjs отрисовывает тур кадр за кадром в MP4 с частотой 60fps (или в листы с кадрами для просмотра), а процедурный звук сводится до -14 LUFS с использованием сэмплов CC0 с Freesound.
Автор
elvarofficial
Размер
17.8 MB
Звёзды
3.7K
Обновлён
КоммитOct 31
Возраст
19 д
Коммиты · 90 дней