Repolode
投稿する
AirsupHQ

AirsupHQ/machine-skill

機械の一行説明から、物理ベースのインタラクティブな3Dシミュレーションと短編動画を単一ファイルで生成するClaude Codeスキルです。

GitHub で見る公式サイト
スター
593
フォーク
78
未解決の Issue
4
最終コミット
25 日前

これは何？

Machine Skillは、Claude Code向けのオープンソースAgent Skillです。ターボファンエンジンや機械式時計のムーブメントなどを一行で説明すると、Claudeが実際の寸法や運転点を調査し、ブラウザー上で動作するthree.js製の自己完結型HTMLページとして構築します。各機械には専用の小さな物理ソルバーが含まれ（ガスタービンならブレイトンサイクル、ピストンエンジンならスライダークランクモデルなど）、動きと表示数値を制御します。

ページでは、分解表示、断面を実体面で描くカットアウェイ、X線表示、スローモーション、リアルタイムラベルを利用できます。また、計算に基づく破損モードでは、たとえばケーシングが耐えるべき荷重を表示します。フィルムモードは決定論的なクロックを使うため、同梱のNodeスクリプトで任意の音楽トラックを付けたMP4を録画でき、マゼンタ一色の空フレームを検出して排除するチェックも備えています。

このスキルはnpxまたはgitでClaude Codeにインストールでき、生成したページはWebGL 2対応ブラウザーでディスクから実行できます。録画にはNode 18以降、Playwright、ffmpegが必要です。

主な機能

  • 01説明した機械の単一ファイルHTML 3Dモデルを、ビルド工程なしで生成します。
  • 02機械ごとの物理ソルバーで、動きと表示値を制御します。
  • 03分解表示、断面を実体面で描くカットアウェイ、X線表示、リアルタイムラベルを利用できます。
  • 04破損や荷重をシミュレーションする、計算に基づく破損モードを備えています。
  • 05任意の音楽を付けて、Nodeスクリプトから決定論的なMP4動画を録画できます。

ユースケース

  • エンジンや機構を説明する、教材向けのインタラクティブなページを作成する。
  • 機械の短いアニメーション動画を制作し、SNSに投稿する。
  • 設備のカットアウェイ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 が必要です。

収録されている特集

Claude Code のツール・スキル・プラグインAI エージェントのスキル集オープンソースの教育・学習ツールロボティクス・身体性AIプロジェクト

トピック

#agent-skills#claude-code#threejs#webgl#simulation#physics#3d-visualization#education#claude#claude-skill

よくある質問

machine-skill とは？
機械の一行説明から、物理ベースのインタラクティブな3Dシミュレーションと短編動画を単一ファイルで生成するClaude Codeスキルです。 Machine Skillは、Claude Code向けのオープンソースAgent Skillです。ターボファンエンジンや機械式時計のムーブメントなどを一行で説明すると、Claudeが実際の寸法や運転点を調査し、ブラウザー上で動作するthree.js製の自己完結型HTMLページとして構築します。各機械には専用の小さな物理ソルバーが含まれ（ガスタービンならブレイトンサイクル、ピストンエンジンならスライダークランクモデルなど）、動きと表示数値を制御します。
machine-skill は無料で使えますか？ライセンスは？
machine-skill は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
machine-skill は今もメンテナンスされていますか？
活発にメンテナンス中。machine-skill の最終コミットは 2026年10月13日 です。
machine-skill は何に使えますか？
エンジンや機構を説明する、教材向けのインタラクティブなページを作成する。 機械の短いアニメーション動画を制作し、SNSに投稿する。 設備のカットアウェイ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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト