teardown: 아무 기계나 뜯어 볼 수 있는 3D 시뮬레이터로
「기계식 시계는 어떻게 시간을 맞출까」라고 물으면, 분해해 볼 수 있는 3D 시뮬레이터 한 장이 돌아와요
- 누가
- elvarofficial이 만든 Claude Code 스킬이에요. 기계가 어떻게 움직이는지 보여 주거나 배우고 싶은 사람을 위한 거예요.
- 언제
- 2026년 10월 30일에 저장소가 열렸고, 아직 정식 릴리스는 없어요.
- 어디서
- Claude Code에서 써요. 결과는 내 컴퓨터에서 인터넷 없이 열리는 HTML 한 장과, 원하면 mp4 영상이에요.
이게 불편했어요
엔진이나 랜딩기어가 어떻게 움직이는지 설명하려면 그림 몇 장과 긴 글을 붙여야 했어요. 직접 돌려 볼 수 있게 만들려면 3D 코드를 짜거나 모델링 프로그램을 익혀야 했고요. AI에게 문장 하나로 맡기면 어디서 본 듯한 뭉툭한 기계가 나오기 일쑤였어요.
그래서 이렇게 풀어요
teardown은 Claude Code에게 기계를 짓는 방법을 가르치는 스킬이에요. 핵심 규칙은 값 하나가 전부를 움직인다는 거예요. 크랭크 각도 같은 입력 하나에서 부품 위치와 계기판 숫자를 같은 함수로 계산하니, 화면의 숫자가 움직임과 어긋날 수 없어요. 아무도 만지지 않으면 페이지가 스스로 둘러보고, 같은 코드로 60fps 영상까지 녹화해요.



안에서는 이렇게 돌아가요
- 1
- 2
- 3
Claude Code → sims/build.mjs
기계 폴더: kin.js, stage.js, console.js, live.js수학, 형상, 조명, 패널, 실시간 조작을 파일별로 나눠 써요. 예제 V8은 크랭크 각도 하나로 움직여요.sims/v8-shared/kin.js - 4
sims/build.mjs → teardown-out
three.js와 글꼴을 넣은 HTML 한 장기계를 인터넷 없이 열리는 HTML 파일 하나로 묶어 teardown-out/dist에 써요.sims/build.mjs - 5
Claude Code → sims/capture.mjs
--stills beats 검토 시트장면마다 정지 화면을 찍어 읽고, 겹치거나 잘린 곳을 고쳐 다시 빌드해요.sims/capture.mjs - 6
sims/capture.mjs → teardown-out
프레임 단위로 렌더한 60fps mp4둘러보기를 영상으로 녹화하고, 같은 타임라인에 맞춘 소리를 붙여요.sims/capture.mjs
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 수업이나 발표에서 기계 원리를 움직이는 그림으로 보여 주고 싶을 때
- 공학이나 물리를 공부하며 부품을 직접 열어 보고 싶을 때
- 장치를 소개하는 짧은 영상이 필요할 때
- 링크 하나로 공유할 가벼운 데모 페이지가 필요할 때
이건 안 돼요
- 영상에는 ffmpeg, 소리에는 Python 3가 따로 필요해요.
- 참고 사진이나 단면도 없이 문장만으로 만들면 기계가 뻔한 모양이 된다고 SKILL.md가 직접 경고해요.
- 내장 GPU 노트북에서는 프레임이 크게 떨어질 수 있어, 예제에 품질 단계를 따로 둬요.
- Claude Code용 스킬로 만들어졌어요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요