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 – 1行の説明をインタラクティブな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が必要です。モバイルブラウザは軽量版を実行できます。
このスキルは機械や機構に焦点を当てており、人物、風景、複雑な流体構造相互作用は扱いません。

ヘルプ・貢献

Issueを開くか、新しい機械の説明を含むプルリクエストを送信してください。
リポジトリには、将来のアイデアのための V2-IDEAS.md と、自動テストのプロンプトと応答の期待値を定義する evals/evals.json が含まれています。

結論： Machine Skill を使用すると、実際の機械を説明する1文を入力するだけで、インタラクティブな物理ベースの3Dウェブシミュレーションと公開可能な動画を即座に受け取ることができます。これは、ブラウザと録画用の適度なNode環境のみを必要とする、完全に機能するオープンソースのClaude Codeスキルです。

上記の詳細はすべてプロジェクトのREADMEから直接引用したものであり、外部の推測は一切含まれていません。

AirsupHQ/machine-skill