Repolode
elvarofficial

elvarofficial/teardown

분해 가능한 기계를 인터랙티브한 오프라인 3D 시뮬레이터로 만들어 단일 HTML 페이지로 제공하는 Claude Code 스킬입니다.

스타
2,145
포크
332
열린 이슈
0
마지막 커밋
6일 전

어떤 프로젝트인가요?

teardown은 기계의 작동 원리를 설명하는 Claude Code 스킬입니다. 오토바이 엔진이나 기계식 시계처럼 원하는 대상을 입력하면 Claude가 기계를 3D 장면으로 만들고, 오프라인에서 실행되는 단일 HTML 페이지로 패키징합니다. 화면 중앙에서는 기계가 작동하고 주변 패널에는 실제 계산된 값이 표시되며, 버튼을 누르면 작동을 담당하는 부품만 따로 볼 수 있습니다.

페이지를 그대로 두면 내장된 기계 안내 투어가 재생됩니다. 저장소에는 이 투어를 프레임 단위로 렌더링해 60 fps mp4 동영상이나 검토용 스틸 이미지 시트로 만드는 캡처 도구와, 동영상 타임라인에 오디오를 믹싱하는 절차적 사운드 시스템도 포함되어 있습니다.

저장소에는 완성된 예제 기계 세 가지가 포함되어 있습니다. V8 4행정 엔진, Cessna 337의 메인 랜딩기어, Strandbeest SB-10 보행 메커니즘입니다. 설치하려면 npx skills add를 실행한 뒤 npm install과 Playwright Chromium 설정을 한 번 진행하면 됩니다. Node.js 20 이상이 필요하며, 동영상과 사운드 기능에는 ffmpeg와 Python 3도 필요합니다.

핵심 기능

  • 01기계를 인터랙티브한 3D 장면으로 생성해 오프라인에서 실행되는 단일 HTML 파일로 제공합니다.
  • 02주변 패널에 시뮬레이션에서 실시간으로 계산한 값이 표시됩니다.
  • 03버튼을 눌러 작동을 담당하는 부품을 따로 분리해 자세히 살펴볼 수 있습니다.
  • 04페이지를 유휴 상태로 두면 안내 투어가 자동으로 재생됩니다.
  • 05투어를 60 fps mp4 동영상이나 검토용 스틸 이미지 시트로 렌더링합니다.
  • 06동영상 타임라인에 -14 LUFS로 마스터링된 절차적 사운드를 추가합니다.

활용 사례

  • 학생이나 동료에게 엔진, 메커니즘 또는 시계의 작동 원리를 설명할 때.
  • 기계 설계를 짧은 애니메이션 안내 동영상으로 제작할 때.
  • 오프라인에서 공유할 수 있는 인터랙티브 기계 다이어그램을 만들 때.

빠른 시작

  1. 1

    npx로 스킬 설치

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

    설치된 폴더에서 종속성과 Chromium 설치

    npm install && npx playwright install chromium
  3. 3

    예제 시뮬레이터 빌드(HTML 페이지 하나로 열립니다)

    node sims/build.mjs v8-live

사용 전 알아둘 점

  • 새 시뮬레이터를 생성하려면 Node.js 20 이상과 Claude Code가 필요합니다.
  • 동영상 출력에는 ffmpeg도 필요하고, 사운드 생성에는 Python 3이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

teardown은(는) 무엇인가요?
분해 가능한 기계를 인터랙티브한 오프라인 3D 시뮬레이터로 만들어 단일 HTML 페이지로 제공하는 Claude Code 스킬입니다. teardown은 기계의 작동 원리를 설명하는 Claude Code 스킬입니다. 오토바이 엔진이나 기계식 시계처럼 원하는 대상을 입력하면 Claude가 기계를 3D 장면으로 만들고, 오프라인에서 실행되는 단일 HTML 페이지로 패키징합니다. 화면 중앙에서는 기계가 작동하고 주변 패널에는 실제 계산된 값이 표시되며, 버튼을 누르면 작동을 담당하는 부품만 따로 볼 수 있습니다.
teardown은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
teardown은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
teardown은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. teardown의 마지막 커밋은 2026년 10월 31일입니다.
teardown은(는) 어디에 사용할 수 있나요?
학생이나 동료에게 엔진, 메커니즘 또는 시계의 작동 원리를 설명할 때. 기계 설계를 짧은 애니메이션 안내 동영상으로 제작할 때. 오프라인에서 공유할 수 있는 인터랙티브 기계 다이어그램을 만들 때.
teardown는 어떻게 설치하나요?
npx로 스킬 설치: npx skills add elvarofficial/teardown -g -a claude-code 설치된 폴더에서 종속성과 Chromium 설치: npm install && npx playwright install chromium 예제 시뮬레이터 빌드(HTML 페이지 하나로 열립니다): node sims/build.mjs v8-live
teardown은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/elvarofficial/teardown

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트