Describe any machine in one line. Claude builds a photoreal, physics based, interactive simulation of it in one HTML file, plus the film to post it. An open source Claude Code skill.

Machine Skill – 한 줄 설명을 대화형 3D 시뮬레이션으로 변환

개요 – Claude Code(및 기타 Claude 호환 에이전트)를 위한 에이전트 기술로, 다음과 같은 짧은 텍스트 프롬프트를

/machine a turbofan jet engine, the kind that pushes a wide‑body off the runway

완벽한 기능을 갖춘 사실적인 3D 웹 페이지로 변환합니다. 이 페이지는 실제 크기의 기계를 보여주며, 절차적으로 생성된 기하학적 구조로 구축되고, three.js로 렌더링되며, 추력, 압력, 속도 등을 계산하는 경량 물리/열역학 솔버에 의해 구동됩니다. 이 기술은 또한 구축, 작동, 단면 및 "파손" 시퀀스를 포함하는 30초 분량의 결정론적 영상을 기록할 수 있습니다.

빠른 시작(비전문가용)

기술 설치
```
npx skills add AirsupHQ/machine-skill -g -a claude-code
```
이 명령은 저장소를 ~/.claude/skills/machine에 복사하여 Claude Code가 로드할 수 있도록 합니다.
Claude에게 요청 Claude Code에서 /machine으로 시작하는 줄 뒤에 설명을 입력합니다. 예:
```
/machine a mechanical watch movement, the escapement ticking
```
Claude는 watch.html과 같은 파일을 반환합니다.
보기/상호작용 생성된 HTML을 최신 브라우저에서 엽니다. 뷰를 드래그하거나, 어셈블리를 분해하거나, 단면을 자르거나, 실시간 라벨을 보거나, 솔버가 기계를 "파손"하게(예: 팬 블레이드를 날려 계산된 부하 확인) 할 수 있습니다.
영상 기록(선택 사항)
```
node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 \
     --music freepd:Classical/Easy_Lemon
```
이 스크립트는 시뮬레이션을 프레임별로 단계적으로 실행하여 매번 동일한 출력을 보장합니다.

기술을 통해 얻을 수 있는 것

기능	의미
실제 비율	기계는 미터 단위로 모델링되며, 15~40개의 명명된 부품과 수천 개의 고체 부품(블레이드, 볼트, 기어 등)으로 구성됩니다. 스케일 바가 실제 크기를 보여줍니다.
물리 기반 재질	강철, 티타늄, 인코넬, 구리, 황동, 알루미늄, 폴리머, 유리, 사파이어 등 각각 측정된 반사율과 적절한 마감(브러시, 광택, 열광)을 갖추고 있습니다.
스튜디오 품질 조명	소프트박스 키 라이트, 앰비언트 오클루전, 블룸 및 선택적 야간 또는 종이 배경이 움직임이 시작되기 전에 제품 사진 같은 외관을 제공합니다.
실시간 물리 솔버	각 기계에는 소형의 독립형 솔버(터빈용 브레이턴 사이클, 로켓 챔버 방정식, 펌프 상사 법칙 등)가 포함되어 있습니다. 화면에 표시되는 숫자는 즉석에서 계산되며 페이지에 지배 방정식이 나열됩니다.
상호작용 모드	분해, 단면(해칭이 있는 단면), X-레이, 슬로우 모션, 일시 정지 및 사용자 지정 오류(예: 블레이드 탈락, 펌프 캐비테이션)를 적용하는 결정론적 "파손" 모드.
원클릭 영상	`?film=1`을 추가하면 시뮬레이션이 레코더와 동기화되어 28초 분량의 결정론적 비디오를 생성합니다. `record.mjs` 스크립트는 음악, 마젠타 프레임 가드 및 선택적 핑크 스캔 검증을 추가합니다.

작동 원리(개요)

SKILL.md – Claude가 읽는 매니페스트; 워크플로우(연구 → 기하학 → 재질 → 솔버 → 렌더링 → 영상)와 화면 텍스트 스타일을 정의합니다.
kit/lab-kit.js – 생성된 모든 HTML 페이지에 인라인되는 단일 ES 모듈(빌드 단계 없음). CDN에서 three.js 0.170을 가져와 다음을 제공합니다:
- 블레이드, 기어, 케이싱 등을 위한 기하학 빌더
- 사실적인 PBR 값을 가진 재질 라이브러리
- 단면 렌더링(자동 생성된 단면 캡이 있는 평면 클리핑)
- 분해, 라벨 및 영상 타임라인을 위한 UI 도우미.
references/solvers.md – 실제 상수가 포함된 소형 물리 레시피(예: 브레이턴 사이클, 로켓 노즐 팽창, 펌프 곡선) 모음. 투명성을 위해 사용된 방정식이 페이지에 표시됩니다.
scripts/ – 스크린샷(shot.mjs), 결정론적 비디오 캡처(record.mjs), 핑크 프레임 감지(pinkscan.mjs) 및 키트 인라인화(inline.mjs)를 위한 유틸리티.
examples/ – 직접 열 수 있는 완성된 HTML 파일(터보팬, 로켓 엔진, 정유 펌프, 압축기 등).

누가 사용할 수 있나요?

교육자 및 트레이너 – 항공우주, 발전소 또는 기계 공학 과정을 위한 대화형 물리 기반 시각화.
콘텐츠 제작자 – 소셜 미디어 또는 기술 블로그를 위한 고품질 3D 설명 영상의 빠른 생성.
엔지니어 – 전체 CAD/CFD 파이프라인 없이 설계의 기본 성능을 빠르게 "가정" 시각적으로 확인.
AI 애호가 – 자연어 프롬프트를 물리 기반 그래픽으로 연결하는 에이전트 기술의 구체적인 예.

제한 사항(README에 명시된 대로)

물리 효과는 단순화된 모델이며 CFD나 유한 요소 해석이 아닙니다. 결과는 설명용으로는 좋지만 인증용으로는 적합하지 않습니다.
기하학적 구조는 절차적 three.js이며 비율과 부품 수는 정확하지만 제조 공차에는 적합하지 않습니다.
무거운 장면(약 60만 개의 삼각형)은 적절한 GPU가 필요하며, 모바일 브라우저는 가벼운 버전을 실행할 수 있습니다.
이 기술은 기계 및 메커니즘에 중점을 두며 사람, 풍경 또는 복잡한 유체-구조 상호작용은 처리하지 않습니다.

도움 받기 / 기여하기

이슈를 열거나 새로운 기계 설명이 포함된 풀 리퀘스트를 제출하세요.
저장소에는 향후 아이디어를 위한 V2-IDEAS.md와 자동화된 테스트를 위한 프롬프트-응답 기대치를 정의하는 evals/evals.json이 포함되어 있습니다.

결론: Machine Skill을 사용하면 실제 기계를 설명하는 한 문장을 입력하는 것만으로 대화형 물리 기반 3D 웹 시뮬레이션과 게시 가능한 비디오를 즉시 받을 수 있습니다. 이는 브라우저와 기록을 위한 적절한 Node 환경만 있으면 되는 완전한 기능을 갖춘 오픈 소스 Claude Code 기술입니다.

위의 모든 세부 정보는 프로젝트의 README에서 직접 가져온 것이며 외부 추측은 추가되지 않았습니다.

AirsupHQ/machine-skill