AirsupHQ/machine-skill

어떤 프로젝트인가요?

핵심 기능

• 01설명한 기계를 단일 파일 HTML 3D 모델로 빌드하며, 빌드 단계가 필요하지 않습니다.
• 02기계별 물리 솔버로 움직임과 화면에 표시되는 값을 계산합니다.
• 03분해 보기, 단면을 실체감 있게 보여 주는 컷어웨이, 엑스레이, 실시간 레이블을 제공합니다.
• 04고장과 하중을 시뮬레이션하는 계산 기반 고장 모드를 포함합니다.
• 05선택 사항인 음악을 넣어 Node 스크립트로 결정론적 MP4 영상을 녹화합니다.

활용 사례

• 교육용 엔진 또는 기계 장치 인터랙티브 설명 페이지 제작.
• 소셜 미디어 피드에 올릴 기계 애니메이션 짧은 영상 제작.
• 교육 또는 문서화 사이트에 장비 컷어웨이 3D 모델 삽입.
• 작동 조건에 따라 기계 모델의 수치가 어떻게 달라지는지 살펴보기.

빠른 시작

1. 1

   Claude Code에 스킬을 설치합니다

   npx skills add AirsupHQ/machine-skill -g -a claude-code
2. 2

   Claude Code에서 만들고 싶은 기계를 설명합니다

   /machine a mechanical watch movement, the escapement ticking
3. 3

   생성된 페이지를 동영상으로 녹화합니다(Node와 ffmpeg 필요)

   node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

사용 전 알아둘 점

• !주로 기계, 엔진, 메커니즘, 장치를 대상으로 합니다. 사람, 풍경, 지도는 결과가 다소 미흡할 수 있습니다.
• !물리 시뮬레이션은 단순화된 소규모 모델이며 CFD나 FEA가 아닙니다. 수치도 인증된 값이 아닙니다.
• !복잡한 페이지를 최고 속도로 실행하려면 WebGL 2를 지원하는 실제 GPU가 필요합니다.
• !동영상 녹화에는 Node 18 이상, Playwright, ffmpeg가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

machine-skill은(는) 무엇인가요?

기계에 대한 한 줄 설명을 단일 파일로 된 물리 기반 인터랙티브 3D 시뮬레이션과 짧은 영상으로 바꿔 주는 Claude Code 스킬입니다. Machine Skill은 Claude Code용 오픈 소스 Agent Skill입니다. 터보팬 엔진이나 기계식 시계 무브먼트처럼 기계를 한 줄로 설명하면, Claude가 실제 치수와 작동 조건을 조사한 뒤 브라우저에서 three.js를 사용해 독립 실행형 HTML 페이지로 구현합니다. 페이지에는 기계별 소형 물리 솔버가 포함됩니다. 예를 들어 가스터빈에는 Brayton 사이클을, 피스톤 엔진에는 슬라이더 크랭크 모델을 적용해 움직임과 화면에 표시되는 수치를 계산합니다.

machine-skill은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

machine-skill은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

machine-skill은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. machine-skill의 마지막 커밋은 2026년 10월 13일입니다.

machine-skill은(는) 어디에 사용할 수 있나요?

교육용 엔진 또는 기계 장치 인터랙티브 설명 페이지 제작. 소셜 미디어 피드에 올릴 기계 애니메이션 짧은 영상 제작. 교육 또는 문서화 사이트에 장비 컷어웨이 3D 모델 삽입. 작동 조건에 따라 기계 모델의 수치가 어떻게 달라지는지 살펴보기.

machine-skill는 어떻게 설치하나요?

Claude Code에 스킬을 설치합니다: npx skills add AirsupHQ/machine-skill -g -a claude-code Claude Code에서 만들고 싶은 기계를 설명합니다: /machine a mechanical watch movement, the escapement ticking 생성된 페이지를 동영상으로 녹화합니다(Node와 ffmpeg 필요): node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

machine-skill은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AirsupHQ/machine-skill