AI 칼럼

배우기@donghyeok99운영진

teardown: 아무 기계나 뜯어 볼 수 있는 3D 시뮬레이터로

「기계식 시계는 어떻게 시간을 맞출까」라고 물으면, 분해해 볼 수 있는 3D 시뮬레이터 한 장이 돌아와요

README의 V8 예제처럼, 엔진이 돌며 계기판이 같은 숫자를 읽고 단면 버튼을 누르면 피스톤이 드러나며 점화 순서 1-8-4-3-6-5-7-2대로 실린더가 켜지는 장면이에요.
README의 V8 예제처럼, 엔진이 돌며 계기판이 같은 숫자를 읽고 단면 버튼을 누르면 피스톤이 드러나며 점화 순서 1-8-4-3-6-5-7-2대로 실린더가 켜지는 장면이에요.
누가
elvarofficial이 만든 Claude Code 스킬이에요. 기계가 어떻게 움직이는지 보여 주거나 배우고 싶은 사람을 위한 거예요.
언제
2026년 10월 30일에 저장소가 열렸고, 아직 정식 릴리스는 없어요.
어디서
Claude Code에서 써요. 결과는 내 컴퓨터에서 인터넷 없이 열리는 HTML 한 장과, 원하면 mp4 영상이에요.

이게 불편했어요

엔진이나 랜딩기어가 어떻게 움직이는지 설명하려면 그림 몇 장과 긴 글을 붙여야 했어요. 직접 돌려 볼 수 있게 만들려면 3D 코드를 짜거나 모델링 프로그램을 익혀야 했고요. AI에게 문장 하나로 맡기면 어디서 본 듯한 뭉툭한 기계가 나오기 일쑤였어요.

그래서 이렇게 풀어요

teardown은 Claude Code에게 기계를 짓는 방법을 가르치는 스킬이에요. 핵심 규칙은 값 하나가 전부를 움직인다는 거예요. 크랭크 각도 같은 입력 하나에서 부품 위치와 계기판 숫자를 같은 함수로 계산하니, 화면의 숫자가 움직임과 어긋날 수 없어요. 아무도 만지지 않으면 페이지가 스스로 둘러보고, 같은 코드로 60fps 영상까지 녹화해요.

README 맨 위의 로봇 벌 시뮬레이터, 가운데서 기계가 돌고 둘레 패널이 숫자를 읽어요
README 맨 위의 로봇 벌 시뮬레이터, 가운데서 기계가 돌고 둘레 패널이 숫자를 읽어요
로봇 전갈 시뮬레이터, 같은 방식으로 만든 다른 기계예요
로봇 전갈 시뮬레이터, 같은 방식으로 만든 다른 기계예요
로봇 문어 시뮬레이터, 부품마다 버튼으로 열어 볼 수 있어요
로봇 문어 시뮬레이터, 부품마다 버튼으로 열어 볼 수 있어요

안에서는 이렇게 돌아가요

  1. 1

    사용자 → Claude Code

    「기계식 시계는 어떻게 시간을 맞출까, 시뮬레이터로」기계 이름이나 궁금한 원리를 평소 말로 물어요.README.md
  2. 2

    Claude Code → SKILL.md

    기계 짓는 법, 규칙, 검토 루프실제 치수를 먼저 찾고, 입력 하나로 모든 부품과 숫자를 움직이라는 규칙을 읽어요.SKILL.md
  3. 3

    Claude Code → sims/build.mjs

    기계 폴더: kin.js, stage.js, console.js, live.js수학, 형상, 조명, 패널, 실시간 조작을 파일별로 나눠 써요. 예제 V8은 크랭크 각도 하나로 움직여요.sims/v8-shared/kin.js
  4. 4

    sims/build.mjs → teardown-out

    three.js와 글꼴을 넣은 HTML 한 장기계를 인터넷 없이 열리는 HTML 파일 하나로 묶어 teardown-out/dist에 써요.sims/build.mjs
  5. 5

    Claude Code → sims/capture.mjs

    --stills beats 검토 시트장면마다 정지 화면을 찍어 읽고, 겹치거나 잘린 곳을 고쳐 다시 빌드해요.sims/capture.mjs
  6. 6

    sims/capture.mjs → teardown-out

    프레임 단위로 렌더한 60fps mp4둘러보기를 영상으로 녹화하고, 같은 타임라인에 맞춘 소리를 붙여요.sims/capture.mjs

넣으면 이렇게 나와요

node sims/build.mjs v8-live유리 실린더 V8, 점화 순서 1-8-4-3-6-5-7-2로 실린더를 골라 보는 페이지
세스나 337 주 랜딩기어201mm 랙이 32톱니 피니언을 정확히 180° 돌리며 기체 안으로 접히는 장면
테오 얀선의 스트랜드비스트다리 20개가 크랭크축 하나로 모래 위를 걷고, 발자국이 차트로 그려지는 장면

나한테 맞을까요

이럴 때 좋아요

  • 수업이나 발표에서 기계 원리를 움직이는 그림으로 보여 주고 싶을 때
  • 공학이나 물리를 공부하며 부품을 직접 열어 보고 싶을 때
  • 장치를 소개하는 짧은 영상이 필요할 때
  • 링크 하나로 공유할 가벼운 데모 페이지가 필요할 때

이건 안 돼요

  • 영상에는 ffmpeg, 소리에는 Python 3가 따로 필요해요.
  • 참고 사진이나 단면도 없이 문장만으로 만들면 기계가 뻔한 모양이 된다고 SKILL.md가 직접 경고해요.
  • 내장 GPU 노트북에서는 프레임이 크게 떨어질 수 있어, 예제에 품질 단계를 따로 둬요.
  • Claude Code용 스킬로 만들어졌어요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기