Communitygithub.com

motion-craft

コードベースのアニメーション動画(9:16 Shorts、16:9 Video、15秒~10分)を生成するスキル。3D、アイソメトリック、スティックマン、天文学など16のビジュアルカテゴリに対応。

motion-craft とは?

このスキルは、わずか1文のアイデアから高品質なアニメーション動画を生成する、ゼロ依存のエージェントスキルです。3D、アイソメトリック、スティックマン3D、天文学(GLSLブラックホール)、動物、海洋、科学・自然、歴史、地図(Natural Earth d3-geo)、イスラム、地理、解剖学、民話、漫画、2Dアニメーションなど、16のスタジオ級ビジュアルカテゴリをサポートします。出力は、視覚的推奨、段階的なスクリプト(フック→シーン1~N)、ブラウザで直接再生可能なスタンドアロンHTMLファイル、ソースコードZIP、決定論的なMP4動画です。Claude Code、Coder、Cursorなどの環境で動作し、ユーザーがアニメーション動画、教育用Shorts、解説動画、3Dシミュレーション、歴史/地理マップ、スティックマン3D、解剖図、ストーリーボードをリクエストした際に特に有用です。実装はNode.jsの組み込みモジュールのみに依存し、npm依存関係は一切不要です。コードは実行のたびに完全に決定論的で、Math.randomやDate.nowは使用せず、独自の乱数生成器とtweenベースのアニメーションを使用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

MotionCraft — 16カテゴリの動画解説&Shortsを生成するユニバーサルエージェントスキル

ゼロ依存のスタンドアロンスキル。たった1文のアイデアから、ビジュアル方向性の推奨、段階的スクリプト(HOOK → ADEGAN 1 → ADEGAN 2 → …(最大10分))、スタンドアロンHTMLファイル <slug>.html(ダブルクリックでブラウザで動作、9:16 ↔ 16:9 切り替えボタン、WebAudio SFX対応)、ソースコードZIP <slug>-source.zip、そしてMP4動画レンダリングを生成します。


必須ワークフロー(5ステップ)

ステップ 1 — ビジュアル推奨とスクリプト計画(HOOK → ADEGAN 1..N)

ユーザーがアイデアを提供したら(アスペクト比や長さが指定されていない場合、簡潔なファクトの場合はデフォルトで 9:16 Shorts 30–45秒、深い議論の場合は 16:9 動画 60–600秒 を使用):

  1. 16の公式カテゴリから最も適切なものを1つ選択: 3D · アイソメトリック · 家の解体 · スティックマン3D · 天文学 · 動物 · 海 · 科学と自然 · 歴史 · 地図 · イスラム · 地理 · 解剖学 · 民話 · 漫画 · 2Dアニメーション

  2. 具体的なビジュアル推奨を策定:

    • オブジェクトと小道具(objek):テクスチャ/関節を持つ主要被写体 + スケール比較/証拠のための最低3つの小道具。
    • カメラとトランジション(kamera):マルチショットパターン(wide → close-up 詳細 → orbit / whipTo / pull-back)。
    • 雰囲気と照明(suasana):空/宇宙の雰囲気、フォギー/ボリューメトリックライト、カラーパレット、ナレーションのトーン。
  3. 段階的スクリプトを作成(0 ~ DUR 秒、空白なし):

    • 最初の部分は必須で HOOK(好奇心を誘う導入部、3~10秒)。
    • その後 ADEGAN 1、ADEGAN 2、…と続き、強力な事実に基づく結論で締めくくる(約2.2語/秒)。
    • 長尺(60秒超、最大 600 秒 / 10分)の場合は、長尺10分ガイドを参照。

ステップ 2 — カテゴリレシピとコードサンプルのゴールデンスタンダードを読む(必須!)

推測で sceneCode を書かないでください! アニメーションコードを書く前に:

  1. 16カテゴリカタログのカテゴリテーブルと style ID、およびエンジンv4 APIリファレンス(MF)のランタイム関数リストを読む。
  2. コードリファレンスのゴールデンスタンダードで最も近い公式コード例を読む。
  3. 品質均等の法則:オブジェクトの密度、テクスチャ詳細(CanvasTexture / レイヤーSVG / world-atlas 海岸線 / GLSLシェーダー)、照明、カメラの滑らかさは、golden-showcases.md の例と同等でなければなりません。テクスチャや小道具のない単純な四角や丸を描いてはいけません!

ステップ 3 — sceneCode 記述の黄金律

sceneCode は関数 (MF, stage, tl, W, H, DUR) の本体として実行されます:

  • デュアルレスポンシブ(9:16 Shorts & 16:9 動画):常に W と H の比率を使用(W * 0.5、H * 0.45、size: W < H ? 50 : 56、labelX: W < H ? W * 0.08 : W * 0.54)。1080×1920 でも 1920×1080 でもアニメーションが途切れずに表示されるようにします。
  • 変数 H を上書きしない:const { H } = MF; と書かないでください。ステージの高さ H を上書きしてしまいます! 常に MF. プレフィックス(MF.H、MF.S、MF.T)で呼び出してください。
  • 100% 決定論的:Math.random()、Date.now()、setTimeout、setInterval は使用禁止です。 MF.rng('固定シード')、tl 上のトゥイーン、時間 t の純粋関数としての MF.onTick((t) => ...) を使用してください。
  • フレーム0からすぐに表示:HOOK のステージ要素とオープニングタイトルは、最初のフレームが空白/暗くならないように at: 0 を使用する必要があります。
  • アンチPPT:同時に表示するのは最大1つのヘッドライン(MF.highlightHeadline)+ 1つのコールアウト/数字(MF.leaderCallout / MF.bigStat)にしてください。ストーリーは、テキストカードの連続ではなく、ワールド/オブジェクトのアクション変化とカメラの動きで伝える必要があります!

ステップ 4 — スタンドアロンファイルの作成(.html、-source.zip、-naskah.md)

JSON仕様ファイル(例:spec.json)を作成します:

{
  "title": "動画タイトル",
  "idea": "ユーザーの元のアイデア",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objek": "…",
    "kamera": "…",
    "suasana": "…"
  },
  "scenes": [
    { "label": "HOOK", "title": "…", "start": 0, "end": 7, "narration": "…", "visualBeat": "…" },
    { "label": "ADEGAN 1", "title": "…", "start": 7, "end": 18, "narration": "…", "visualBeat": "…" }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); …"
}

次に、スタンドアロンビルドスクリプト(Node.js組み込みモジュールのみ、npm 依存関係ゼロ!)を実行します:

node "<スキルへのパス>/scripts/build.mjs" --spec path/ke/spec.json --out-dir path/tujuan

このスクリプトは sceneCode の構文と決定論を検証し、./assets/motion-engine.js、./assets/sfx-synth.mjs、および(地図を使用する場合は)./assets/land-110m.json を埋め込み、以下を生成します:

  1. <slug>.html — 任意のブラウザで視聴可能なスタンドアロンファイル(自動ループ + スクラブバー + 9:16 ↔ 16:9 切り替えボタン + WebAudio SFX)。
  2. <slug>-source.zip — 完全なソースコードアーカイブ(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。
  3. <slug>-naskah.md — スクリプトとビジュアル推奨のドキュメント。

シェル/Webチャットがない場合のフォールバック:エージェント環境にNode.jsターミナルへのアクセスがない場合は、./assets/starter-template.html の内容をコピーし、プレースホルダー /*__MOTION_ENGINE__*/、/*__SFX_SYNTH__*/、/*__PROJECT_JSON__*/ null を直接置き換えて、完全な index.html ファイルを生成してください。

ステップ 5 — フレーム検証とMP4動画エクスポート(オプション / ヘッドレスブラウザが利用可能な場合)

環境にChrome/Edge + puppeteer-core(または puppeteer)がある場合は、自動検証を実行してランタイムエラーが 0 であることを確認し、スクリーンショットをチェックします:

# クイック検証(0エラーチェック + HOOKと中間のスクリーンショット保存):
node "<スキルへのパス>/scripts/export-mp4.mjs" --html path/tujuan/<slug>.html --verify-only

# 完全MP4動画へのレンダリング(H.264 + AAC SFX自動、オプションで --vo ナレーション.mp3):
node "<スキルへのパス>/scripts/export-mp4.mjs" --html path/tujuan/<slug>.html --fps 30 --scale 1

検証スクリーンショットでエラーやテキストの重なりが見つかった場合は、sceneCode を修正し、scripts/build.mjs で再ビルドしてから、結果をユーザーに提供してください。

関連スキル