teardown의 개요
teardown은 기계가 어떻게 작동하는지 설명하기 위한 Claude Code 스킬입니다. 오토바이 엔진이나 기계식 시계의 시뮬레이터를 요청하면 Claude가 three.js로 오프라인 HTML 페이지 하나를 만듭니다. 기계는 가운데에서 움직이고, 주변 패널은 같은 모델에서 나온 실시간 수치를 보여 주며, 버튼으로 각 하위 시스템을 따로 보거나 잘라 볼 수 있고, 아무도 조작하지 않으면 페이지가 스스로 둘러보기를 진행합니다. 같은 코드로 절차적 사운드트랙이 들어간 60 fps MP4를 프레임 단위로 렌더링합니다.
SKILL.md가 방법을 정합니다. 실제 자료에서 출발하고, 실제 치수를 쓰고, 크랭크 각도 같은 하나의 입력으로 모든 부품을 움직이며, 기계를 완성했다고 하기 전에 렌더링한 정지 화면 시트를 검토합니다. 완성된 예제 세 개가 함께 제공됩니다. 크로스플레인 V8, Cessna 337의 접이식 주 착륙 장치, 그리고 Jansen의 링크 길이 11개로 관절을 계산하는 다리 20개짜리 Strandbeest입니다.
런타임, 프레임 캡처, 사운드 엔진, 검토 규칙은 whaleyxbt/claude-motion에서 왔으며 README도 이를 밝힙니다. 설치는 npx skills add elvarofficial/teardown 후 npm install과 Playwright의 Chromium입니다. Node 20+가 필요하고, 영상과 소리에는 ffmpeg와 Python 3를 씁니다. MIT.
teardown, 쓸 만한 가치가 있습니까?
teardown의 진짜 가치는 자동화보다 예제와 규칙에 있습니다. V8은 연소실 압력 모델과 함께 점화 순서 1-8-4-3-6-5-7-2를 따르고, Cessna의 착륙 장치는 32톱니 피니언 위의 201 mm 랙으로 정확히 180도 회전하며, Strandbeest의 링크 기구 솔버는 67줄입니다. 각 예제는 같은 방식으로 나뉩니다. 순수한 수학은 한 파일에, 형상은 다른 파일에, 그리고 콘솔 오버레이, 대본에 따른 영상, 실시간 페이지가 있어 새 기계를 만들 때 따라 할 명확한 틀이 됩니다.
SKILL.md는 스킬을 쓰지 않더라도 읽어 볼 만합니다. 사진이나 단면도에서 출발할 것, 실제 단위를 쓸 것, 하나의 입력으로 모든 것을 움직여 영상, 페이지, 소리가 어긋나지 않게 할 것, 그리고 Claude는 영상을 볼 수 없으므로 타일로 배열한 정지 프레임을 검토하게 할 것을 요구합니다. Windows에서 겪은 three.js의 구체적인 함정도 기록하고, 링크 미리보기가 작동하도록 페이지를 1 MB 미만으로 유지합니다.
주의할 점: 데모와 결과물의 차이입니다. README에 나온 로봇 벌, 전갈, 문어는 저장소에 없으며, 열린 이슈 하나는 결과물이 데모보다 훨씬 덜 정교하다고 보고합니다. 다른 열린 이슈들은 사운드 코드에 하드코딩된 ffmpeg 경로, 헤드리스 Chromium이 WebGL을 얻지 못해 macOS에서 캡처가 시간 초과되는 문제, sheet.mjs의 경로 탐색 취약점, ?config=에서 온 이스케이프되지 않은 캡션이 생성된 페이지의 innerHTML에 들어가는 문제를 보고하며, 마지막 문제는 페이지를 호스팅할 경우 중요합니다.
저자 한 명이 이틀 동안 만든 프로젝트입니다. 2026년 10월 30일에 만들어졌고, 커밋 두 개, 릴리스 없음, 스타 2,123개입니다. 범용 모션 디자인을 위한 상위 툴킷인 claude-motion과 비교하면 teardown은 범위가 좁고 기계 장치에 더 적합하지만, claude-motion의 런타임을 물려받으면서도 그 수정 사항을 따라갈 업스트림 연결은 없습니다.
제 역할을 하는 곳
기계공학 강사
4행정 엔진의 밸브와 피스톤이 함께 움직이는 모습을 학생들에게 보여 주기
포함된 V8 예제를 빌드하거나, 이를 바탕으로 단기통 버전을 Claude에게 요청합니다. 페이지는 수업 중 오프라인으로 실행되며, 유리, 단면, 솔리드 단면 모드로 사이클을 보여 줍니다.
산업 장비 제조사의 기술 마케팅 작가
제품 메커니즘을 설명하는 20초 영상 제작
제품의 CAD 도면으로 Claude가 기계를 만들게 한 뒤, capture.mjs로 1920 x 1080 프레임을 MP4로 렌더링하고 run_sfx.py로 -14 LUFS에 맞춰 마스터링한 소리를 더합니다. 여러 차례 검토를 예상하십시오.
링크 기구에 관한 블로그 글을 쓰는 개발자
독자가 직접 조작할 수 있는 인터랙티브 모델 삽입
Strandbeest 예제의 링크 기구 솔버와 무대에서 시작해 새 링크 길이로 바꾸고 단일 HTML 파일을 게시합니다. 열린 주입 이슈가 해결될 때까지 URL로 전달하는 캡션은 이스케이프하십시오.
도입 전 확인할 점
- 설정
- npx skills add elvarofficial/teardown -g -a claude-code 후 스킬 폴더에서 npm install과 npx playwright install chromium을 실행합니다. Node 20+, 영상에는 ffmpeg, 소리에는 Python 3가 필요합니다. node sims/build.mjs v8-live로 예제 페이지를 빌드합니다.
- 연동
- Claude Code 스킬. three.js, esbuild, Playwright Chromium. 인코딩에 ffmpeg. CC0 Freesound 샘플을 쓰는 Python 절차적 사운드.
- 데이터와 개인정보
- 모든 렌더링은 로컬에서 이루어지고 페이지는 완전히 오프라인입니다. Claude Code 세션 외에는 아무것도 전송되지 않습니다. MIT.
- 대규모 사용 시 비용
- 공개되지 않았습니다. 기계마다 제작과 검토에 Claude Code 사용량이 들고, 렌더링에는 GPU를 쓸 수 있는 브라우저가 필요합니다.
- 제한
- 열린 이슈 9건이 있으며, 생성된 페이지의 ?config=를 통한 스크립트 주입과 sheet.mjs의 경로 탐색 취약점을 포함합니다. SKILL.md에 따르면 내장 GPU에서는 15 fps까지 떨어질 수 있습니다. Codex와 다른 에이전트는 문서화되어 있지 않습니다.
좋은 점
- 물리적 근거를 갖춘 완성된 예제 기계 세 개
- 따라 하기 쉬운 기계별 파일 구조
- 기계마다 1 MB 미만의 오프라인 HTML 페이지 하나
- 같은 타임라인이 페이지, 영상, 소리를 구동
- Claude가 읽을 수 있는 정지 화면 시트 중심의 검토 루프
아쉬운 점
- README 데모는 포함되지 않았고 결과물이 덜 정교하다는 보고
- 생성된 페이지와 sheet.mjs에 열린 보안 이슈
- macOS 캡처와 ffmpeg 경로 문제 보고
- 저자 한 명, 커밋 두 개, 릴리스 없음
추천 대상
Claude Code를 쓰며 실제 기계 장치의 인터랙티브 단면 해설을 원하고, 첫 초안 이후에도 반복해서 다듬을 의향이 있는 엔지니어, 교사, 기술 작가.
teardown 대안
teardown: 자주 묻는 질문
- teardown, 쓸 만한 가치가 있습니까?
- 훌륭한 예제 기계 세 개와 더 만들기 위한 탄탄한 방법을 갖췄습니다. 다만 한 줄짜리 요청으로 Claude가 만드는 결과물은 데모에 못 미칠 가능성이 큽니다. 평점은 5점 만점에 3.5점입니다.
- teardown의 가격은 얼마입니까?
- MIT로 무료입니다. 기계를 만들 때는 Claude Code 요금제나 API 사용량이 들고, 렌더링은 로컬에서 실행됩니다.
- teardown의 단점은 무엇입니까?
- README 데모는 포함되지 않았고 결과물이 덜 정교하다는 보고; 생성된 페이지와 sheet.mjs에 열린 보안 이슈; macOS 캡처와 ffmpeg 경로 문제 보고; 저자 한 명, 커밋 두 개, 릴리스 없음.
- teardown에 적합한 사람은 누구입니까?
- Claude Code를 쓰며 실제 기계 장치의 인터랙티브 단면 해설을 원하고, 첫 초안 이후에도 반복해서 다듬을 의향이 있는 엔지니어, 교사, 기술 작가.
- 팀이나 프로덕션 환경에서 teardown의 비용은 얼마입니까?
- 공개되지 않았습니다. 기계마다 제작과 검토에 Claude Code 사용량이 들고, 렌더링에는 GPU를 쓸 수 있는 브라우저가 필요합니다.
- teardown에 회사 데이터를 맡겨도 안전합니까?
- 모든 렌더링은 로컬에서 이루어지고 페이지는 완전히 오프라인입니다. Claude Code 세션 외에는 아무것도 전송되지 않습니다. MIT.
- teardown의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Anatomy 및 motionmaxxing입니다.
답변 확인일: 2026년 11월 5일.