Ice Motion Director
インストール

Ice Motion Director

コーディングエージェントのための、モーションデザインと映像のディレクター。企画し、映像をコードとして書き、レンダリングして検証します。

npx skills add Omar-Tnzxo/ice-motion-director -g --all

オープンソース(Apache-2.0)。Claude Code、Codex、Cursor、Gemini CLIほか40以上のエージェントに対応。

Ice Motion DirectorのマスコットIce:紺色の監督ベレー帽をかぶったボクセルの氷キューブが、木製のディレクターズチェアに座りカチンコを持っている

1つの依頼に、1つのルート

1つのルータースキルが依頼とプロジェクトを読み取り、6つのワークフローのうち、ちょうど1つに引き渡します。

ルーターを試す

「このポッドキャストの録音を、アラビア語字幕付きの縦型ショート動画3本に編集して。」

ice-edit編集する映像を渡している

ice-film

ゼロから作る映像。完成したMP4と納品レポート。

ice-explainer

声で何かを説明する。字幕付きのナレーション解説動画。

ice-remake

これと同じ雰囲気で。そのスタイルで、自分の内容を使った新しい映像。

ice-edit

手持ち映像の編集。カット、字幕、縦型バージョン。

ice-lottie

LottieとUIモーション。Lottie JSONまたはアニメーションSVGと開発者向けの引き継ぎ資料。

ice-ideas

作る前のアイデア。すぐ制作に移れるコンセプト一式と台本。

あなた

/ice-motion-director:ice メモアプリのローンチ映像を20秒で作って。サイトはこちら:<あなたのURL>

Ice

サイトと、この業界の広告ルールを確認しました。未決定の項目が2つあります。各質問の最初の選択肢がおすすめです。

  1. どこで流しますか?縦型(SNS向け)横長(サイト向け)正方形3つすべて
  2. ナレーションを入れますか?音楽と画面上の文字ナレーションナレーションと字幕無音

そのあと企画、台本、ストーリーボード、ビルドへ進みます。その場にいれば、本番のビルド前にスタイルフレームを一度確認できます。

/ice-04-storyboard

レビューカード:ストーリーボード

作ったもの
選択肢と採用案
冒頭案を3つ検討。B案を採用:製品が最初の1秒から画面に映るため。
クリティックの指摘
ショット5が長すぎるため、ビートに合わせて短縮。
未決定
エンドカードをコーラルにするか紺にするか。
次へ
「approved, go on」と送ると/ice-05-lookが始まります

このページ用に書いたセッション例です。

ワンプロンプトでも、ステージごとでも

すべての人に

Claude Codeでは、最初のメッセージを/ice-motion-director:iceで始め、作りたい映像を自分の言葉で説明します。短くても長くても構いません。このコマンドを使えば、他の動画スキルが入っていても確実にディレクターが起動します。Iceはまずビジネスについて調べ、プロンプトで決まっていない点をすべて質問します。1つの質問に選択肢は4つで、おすすめが最初。1回のメッセージで質問は最大4つ、未決定の項目が多ければメッセージを分けて聞きます。プロンプトですべて決まっているとき、または「質問しないで」と伝えたときは何も聞きません。それ以外の場合は回答を待ちます。沈黙をイエスとみなすことはありません。その後、回答できる状況であれば一度だけプレビュー(スタイルフレームまたはアニマティック)を見せ、そこからは質問なしで最終ファイルまで進みます。各ステージが終わるたびに、返信を待たずに2行の報告と静止画を送るので、途中でメモを伝えることもできます。決めたことはすべて記録され、納品ノートで説明されます。

自分で舵を取りたい人に

/ice-01-briefから/ice-10-deliverまで、1ステージずつ実行します(Claude Codeで常に動く書き方は/ice-motion-director:ice-01-brief)。各ステージの最後にはレビューカードが出ます:作ったもの、選択肢と採用理由、クリティックの指摘、未決定の項目。修正は何度でも依頼できます。「approved」でそのステージを確定、「approved, go on」で確定して次のステージへ。/ice-statusで現在地を確認できます。

プロンプトの長さで変わるのは、誰が何を決めるかだけ。品質は変わりません。いつでも切り替えられます:途中でステージコマンドを入力するか、/iceで残りを任せます。

10のステージを見る

どの映像も10ステージ

どのルートも、制作会社と同じ10ステージの背骨で動きます。番号は変わらず、順番は映像の種類によって変わります。

映像の種類
仕事の規模

ストーリーから始めます。 標準の順番。04と05は並行して進み、07のビルド中に08aを作り、08bはドラフトに対してミックスします。

  1. ブリーフ

  2. コンセプト

  3. 台本

  4. ストーリーボードルック

  5. アニマティック

  6. ビルドサウンド

  7. ミックス

  8. レビュー

  9. 納品

10ステージすべてをこの順番で実行します。同じ段にある2つのブロックは、エージェントにサブエージェントがあれば並行で、なければ順番に実行されます:04ストーリーボードと05ルック、続いて07ビルドの間に08aサウンド。08bはドラフトに対してミックスします。ステージ10では、言語とアスペクト比ごとに並行してレンダリングします。

ステージ01、ブリーフ

まずリサーチ:ビジネスブリーフ(事業内容、対象、製品の本質、市場と競合、ブランドアイデンティティと本物の素材、現在のキャンペーン、トーン)、ブランド素材の計画、業界とプラットフォームの広告ルール。次にプロジェクトのブリーフと、未決定の項目すべてについての質問:各4択、1回のメッセージで最大4問、必要なら複数回に分けて。

主な成果物 ice/BRIEF.mdice/research/COMPLIANCE.mdice/assets/brand-sheet.jsonice/DIRECTION.md

ルールの出どころ ice-directionのヒアリング、ice-assets

この規模では 全ステージ、少人数のクルー。レビューのラウンド数はice-filmのクルー階層に従います。

各ルートでのステージ01の意味
ice-filmブリーフ
ice-explainerブリーフ
ice-remakeブリーフと参考作品の分析
ice-editブリーフと素材の取り込み
ice-lottieブリーフ
ice-ideasブリーフ

同じ見た目の映像は2つとない

テンプレートやデモは参考であって、デフォルトではありません。映像は、最も近い同梱テンプレートと6つの軸のうち4つ以上が違わなければ先へ進めません。自分で選んだルック(参照、名前を挙げたスタイル、ブランド自身のアイデンティティ)は、それが固定する軸については対象外です。

ルールを試してみましょう。最も近いテンプレートから変える項目にチェックを入れてください:

6つ中2つ

テンプレートに近すぎます。映像はディレクションに差し戻されます。

  • 今日時点のリサーチ

    どの映像も、ブリーフだけをもとにした新しいリサーチから始まります。ブリーフにたどれない検索語は、実行前に外されます。

  • 発散的な企画

    複数の方向性(うち2つ以上は意外なもの)を、別のクリティックが評価します。

  • 映像ごとのフィンガープリント

    完成した映像のパレット、書体、構成をマシン上に保存するので、次の映像が同じものを繰り返すことはできません。

  • デフォルトルックのゲート

    ブリーフに理由がないのに一面の青と紫なら、映像自身のゲートで不合格になります。

作り手は自分を採点しない

独立したクリティックがストーリーボード、フレーム、動き、サウンド、書き出したファイルをレビューします。映像はこの順番ですべてのゲートを通ります。

ボクセルのルーペでフィルムのコマを確認するIce。カチンコを片腕に抱えている
  1. ビルドの前に

    ストーリーボードのlintとレンダリング前のlint、そして何かをレンダリングする前にコンタクトシート。

    ストーリーボードと計画を検証

  2. フレームとつなぎ目

    フレームとつなぎ目のチェック、動きの密度と間延びのチェック、そしてレンダリング結果そのものへの仕上がりゲートで、止まったり飛んだり欠けたりしないようにします。

    すべてのフレームを検証

  3. スロップスキャン

    スロップとPowerPoint風の見た目をスキャンし、ありがちなAIっぽさを先に見つけます。

    ルックを検証

  4. デフォルトルックのゲート

    ブリーフに理由がないのに青と紫ばかりの映像は不合格です。

    パレットを検証

  5. 距離とフィンガープリント

    テンプレートからの距離と、過去の映像とのフィンガープリント照合。

    似通いを検証

  6. 言葉と音

    字幕と同期の検証、書き出したファイルのラウドネスと仕様のチェック、すべての効果音が聞こえることを証明するミックス監査、そして耳で確かめるための短いリスト。

    書き出したファイルを検証

  7. 初見の人の目

    ブリーフを見たことのない新しい視聴者が映像を理解できること、ブランド映像はランダムなフレームでもそのブランドに見えること、そしてクライマックスを参考作品と比較します。

    視聴者を検証

  8. 納品ノート

    レンダリングの承認と、すべての主張に実測値が付いた納品レポート。

    ice/review/NOTE.mdを検証

チェックはレンダリングした動画そのものを測ります。テンポ、奥行き、仕上げ、グレーディング、固定ロゴ、話し手への光、そしてすべての効果音が実際に聞こえるかどうかです。納品レポートの主張には、すべて実測値が付きます。ice/review/NOTE.mdにあります。

すべての映像はコード

HTML、CSS、GSAP、Remotion、Lottie、FFmpeg。映像は毎回同じようにレンダリングされます。普通のノートPCで、GPUも有料の動画モデルも不要です。

ストック映像のように生成されるものはありません。文字、数字、ロゴは承認されたとおりに、常にコードで組まれます。エンジンは映像ごとに選びます:

  • HyperFrames
  • Remotion
  • HTML canvasとPlaywright、FFmpeg
  • Three.js
  • Lottie
  • p5
  • FFmpeg単体

実在のブランドには本物の素材を

実在の企業、製品、アプリの映像では、Iceがそれを調べて本物の素材を集めます:サイトやアプリの実際のキャプチャ、公式ブランドキット、そのサイトから読み取った色とフォント、手を加えないロゴ。ブランドの見た目を推測することはありません。素材が手に入らないときはそう伝え、相談します。「非公式」の表記やAIのラベルを映像に焼き込むことはありません。自分が関わっていないブランドについてのコンセプト映像なら、その一文は納品ノートと投稿キャプション案に入れます。

your-project/  ice/    state.jsonルート、現在のステージ、タイムスタンプ    BRIEF.mdすべての項目に出典を記載    DIRECTION.md各決定、その選択肢と理由    research/日付付きのリサーチメモ    plan/台本、ストーリーボード、ショットプラン、キューシート    review/NOTE.md実測値付きの納品レポート    renders/final/映像とそのバージョン
すべてはプロジェクト内のice/フォルダーに保存されるので、どのセッションからでも前回の続きから再開できます。

アラビア語を第一級に

映像がアラビア語、またはアラビア語と他言語の混在であれば、最初の文字の判断から、アラビア語と右から左(RTL)のルールが適用されます。

مـخـرج

فيلم لتطبيق Notes مدته ٢٠ ثانية

مخرجは「ディレクター」という意味です。カシーダはアラビア語が許す接続部でだけ語を伸ばします。下の行はラテン文字の名前と数字を混ぜても読む順番が崩れません。
  • 動きの中の字形と点
  • 正しい接続部で伸ばすカシーダ
  • 混在行の双方向(Bidi)分離
  • アラビア・インド数字または西洋数字
  • 改行とアラビア語字幕
  • アラビア語のセーフゾーンとカバー文字サイズ
  • 言語ごとのフォントチェック付きフォント選定
  • 台本とナレーションの方言設定
  • 音声認識はタイミング合わせにのみ使用

スタイル156種、コマンドは1つ

/ice-styleと入力するとファミリー別にライブラリを見られます。スタイル名と映像のテーマを添えれば、そのスタイルで制作が始まります。

プリセットが固定するのはルックのファミリーだけです。ブリーフ、リサーチ、コンセプト、品質ゲートはそのまま動くので、スタイルのデモの複製にはなりません。

Satellite Briefing

実在し、ライセンス上問題のない、地理参照付きの衛星写真や航空写真を、アナリスト向けに抑えたトーンでグレーディング...

向いている用途 時間による環境の変化、距離とスケール、調査報道...

出典 lemo-opuscar (LemoLab)

このスタイルで作る

/ice-style satellite-briefing <映像のテーマ>

どのエージェントにもインストール

1行のコマンドで、マシン上にあるすべてのエージェントにインストールできます。主要なエージェントにはネイティブのプラグインでの導入方法もあり、どのエージェントとOSでも手動でコピーする方法を用意しています。

どのエージェントでも

Claude Code、Codex、Cursor、Gemini、Copilot、Windsurf、Cline、Roo、Kilo、OpenCode、Antigravity、Amp、Goose、Kiro、Qwen、Trae、Zed、Warpなど。

npx skills add Omar-Tnzxo/ice-motion-director -g --all
  • マシン上で見つかったすべてのエージェントに、Iceのスキルを確認なしですべてインストールします。
  • すべて入れてください。スキル同士が互いを呼び出すため、一部だけ選ぶと実行が途中で止まります。
  • Node 22.20以降が必要です。あとからのアップデートはnpx skills updateです。

Claude Code

任意のシェルからプラグインとしてインストールします。

claude plugin marketplace add Omar-Tnzxo/ice-motion-director
claude plugin install ice-motion-director@ice-motion-director
  • セッション内では:/plugin marketplace add Omar-Tnzxo/ice-motion-director、続いて/plugin install ice-motion-director@ice-motion-director。

Claude.aiとDesktop

Customize、Plugins、Add、Add marketplaceの順に開き、Omar-Tnzxo/ice-motion-directorを入力します。

  • 先にSettings、CapabilitiesでCode execution and file creationをオンにします。
  • アップデートはプラグインのページのCheck for updatesから。
  • そこで動くもの:ブリーフ、リサーチ、コンセプト、台本、ストーリーボード。レンダリングにはPC上のブラウザとFFmpegが必要ですが、チャットのコードサンドボックスにはない可能性があります(未検証)。映像のレンダリングはClaude Codeなどのローカルエージェントで行ってください。

Codex

CLIとアプリ。

codex plugin marketplace add Omar-Tnzxo/ice-motion-director
codex plugin add ice-motion-director@ice-motion-director
  • またはCodexで/pluginsを実行してそこからインストールし、新しいセッションを始めます。
  • アップデート:codex plugin marketplace upgrade ice-motion-director。CodexアプリではPluginsタブを使います。

Cursor

Cursor用にスキルをインストールします。

npx skills add Omar-Tnzxo/ice-motion-director -a cursor

Gemini CLIとAntigravity

Gemini CLIの拡張機能と、Antigravity CLIのプラグイン。

gemini extensions install https://github.com/Omar-Tnzxo/ice-motion-director
agy plugin install https://github.com/Omar-Tnzxo/ice-motion-director
  • Geminiのアップデートはgemini extensions update ice-motion-director。Antigravity CLIは同じagyコマンドをもう一度実行するとアップデートされます。
  • AntigravityのアプリとIDE:npx skills add Omar-Tnzxo/ice-motion-director -a antigravity。

GitHub Copilot

CLIとVS Code。

copilot plugin marketplace add Omar-Tnzxo/ice-motion-director
copilot plugin install ice-motion-director@ice-motion-director
  • VS Code:コマンドパレットでChat: Install Plugin From Sourceを選び、https://github.com/Omar-Tnzxo/ice-motion-directorを貼り付けます。
  • アップデート:copilot plugin update ice-motion-director。

Qwen Code

拡張機能としてインストールします。

qwen extensions install Omar-Tnzxo/ice-motion-director
  • アップデート:qwen extensions update ice-motion-director。

その他のエージェント

Windsurf、Cline、Roo Code、Kilo Code、OpenCode、Amp、Goose、Kiro、Trae、Zed、Warp、Augmentなど。

npx skills add Omar-Tnzxo/ice-motion-director -a <agent>
  • エージェントID:windsurf、cline、roo、kilo、opencode、amp、goose、kiro-cli、trae、zed、warp、augment。
  • すべてのエージェントとOSの手動コピー先は、リポジトリ内のインストール一覧表にあります。

マシンに必要なもの

選んだルートに必要なものをエージェントが確認し、足りないものを、お使いの環境に合ったコマンド1つとともに伝えます。ルートに必要な無料のパッケージやモデルは、固定バージョンで自動的にインストールし、納品ノートに明記します。有料のものやアカウントが必要なものは、先に確認します。アイデアと台本には何も必要ありません。LottieにはNodeが必要です。納品するすべての映像(映像、解説動画、リメイク、編集)には、Node、FFmpeg、ブラウザ、品質チェック用パッケージを入れたPython 3が必要です。Pythonがないと、リッチさのチェックが動かないため、映像はビルドできても納品できません。

Windowsのインストールコマンド
必要なものコマンド
Node.js(LTS)winget install --id OpenJS.NodeJS.LTS -e
FFmpegwinget install --id Gyan.FFmpeg -e
ChromeまたはChromiumwinget install --id Google.Chrome -e
Python 3winget install --id Python.Python.3.13 -e

Windowsの注意点

  • どのコマンドもPowerShellとcmdで同じように動きます。
  • PowerShellでスクリプトの実行が無効と表示されたら、npx.cmd skills addを使うか、Set-ExecutionPolicy -Scope CurrentUser RemoteSignedで自分のユーザーにだけ一度スクリプトを許可します。
  • --allはPowerShellでもcmdでも同じように動きます(cmdでは--skill '*'が動かないので、--skill "*"のように引用します)。
  • WSLでは、エージェントもWSL内で動いている場合にだけWSL内にインストールします。
macOSのインストールコマンド
必要なものコマンド
Node.js(LTS)brew install node@24
FFmpegbrew install ffmpeg
ChromeまたはChromiumbrew install --cask google-chrome
Python 3brew install python
UbuntuまたはDebianのインストールコマンド
必要なものコマンド
Node.js(LTS)nvm, then nvm install --lts
FFmpegsudo apt install ffmpeg
ChromeまたはChromiumChrome .deb or sudo snap install chromium
Python 3sudo apt install python3 python3-venv
Fedoraのインストールコマンド
必要なものコマンド
Node.js(LTS)sudo dnf install nodejs
FFmpegsudo dnf install ffmpeg-free
ChromeまたはChromiumsudo dnf install chromium
Python 3sudo dnf install python3
Archのインストールコマンド
必要なものコマンド
Node.js(LTS)sudo pacman -S nodejs npm
FFmpegsudo pacman -S ffmpeg
ChromeまたはChromiumsudo pacman -S chromium
Python 3sudo pacman -S python

正確な最低バージョンはskills/ice-engines/references/versions.jsonにあります。全エージェントの手動コピー先:インストール一覧表。

できないこと

  • 実写の撮影はしません。 提供された映像を編集し、それ以外はすべてコードによるモーションデザインで作ります。
  • フォトリアルなCGやキャラクターアニメーションのスタジオではありません。 複雑なキャラクターリグ、リップシンク、重いフォトリアル3Dは守備範囲外です。得意なのは、様式化した2D、キネティックタイポグラフィ、コラージュ、ピクセル、手描き、軽い3Dです。
  • AI動画ジェネレーターではありません。 AIの画像、動画、音声は依頼すれば使えるオプションで、メインのエンジンにはなりません。文字、数字、ロゴは常にコードで組みます。
  • 実在のブランドについて、事実を捏造しません。 実在のブランドには本物の素材を使います。入手できない素材は、提供をお願いします。

プライバシーとネットワーク

  • ローカルで動作。 映像はマシン上でブラウザとFFmpegを使ってレンダリングされます。これらのスキルが何かをアップロードすることはありません。
  • ネットワーク通信はすべて開示。 ディレクションのためのWebリサーチ(エージェント自身の検索ツール経由)、エージェントが自分で選ぶ無料の実在メディア(音楽、効果音、映像、写真、旗、地図、フォント)を公開ライブラリや公式ソースからダウンロードすること(出典とライセンスの状況を付けて、それぞれプロジェクトに記録。名前の挙がった著名人の肖像と公式の旗はWikidataとWikimedia Commonsで探し、自分のライブラリフォルダ(sources.jsonのlocal_libraries)を最初に検索)、Ice専用のCC0効果音パック(録音された128種類の効果音)をプロジェクトのGitHub Releaseから一度だけ取得してSHA-256で検証すること、固定バージョンの無料ツールとモデルのインストール(納品ノートに明記)、選んだフォントがGoogle Fontsのものである場合の取得。ダウンロードは--offlineまたはICE_OFFLINE=1でオフにでき、~/.ice-motion-director/sources.jsonで先に確認を求めるようにもできます。大きなダウンロードやレンダリングの前には空きディスク容量を確認し、余裕のあるドライブで作業します。
  • オプションは依頼時のみ。 AIによる画像、動画、音声の生成、クラウドの文字起こしや音声合成(TTS)。費用がかかる場合があり、同意なしに使うことはありません。
  • ローカルの記憶。 ~/.ice-motion-director/fingerprints.jsonlという小さなフィンガープリントファイルに、完成した映像のパレット、書体、構成を保存し、次の映像が繰り返さないようにします。いつでも削除できます。
  • テレメトリなし。
  • 元のライセンスを保持してコピー
  • アイデアのみ、独自の言葉で書き直し
  • 非商用フォルダー、独自ライセンス
  • 独自ライセンスのまま同梱
  • 創設者自身のスキル

詳細、使った内容、保存場所:CREDITS.md。元のライセンス文:LICENSES/。

よくある質問

紺色のボクセルヘッドホンを着け、両手でイヤーカップを押さえるIce。足元にカチンコが立っている

いいえ。映像はコードとして書かれ、普通のノートPC上のブラウザとFFmpegでレンダリングされます。

はい、作った映像の権利は作った人にあります。noncommercial/という名前の一部の同梱フォルダーには、それぞれの作者による非商用ライセンスが付いています。ワークフローはプロジェクトが商用利用かどうかの回答を確認し、商用の仕事ではそれらのフォルダーを使いません。外部の素材は、見つけたものもあなたが用意したもの(映像素材、音楽、ロゴ)も、ライセンス状況とともに納品ノートに一覧されます。公開前にそれらの権利を処理するのはあなたの役目です。

ice-enginesが映像ごとに選びます:HyperFrames、Remotion、HTML canvasとPlaywright、FFmpeg、Three.js、Lottie、p5、またはFFmpeg単体。Remotionは事業者によっては企業ライセンスが必要です。該当する場合はスキルがお知らせします。

「任せる」または「質問しないで」と伝えてください。Iceが選び、理由をすべてice/DIRECTION.mdに記録し、納品レポートに選んだ内容をすべて載せるので、1回の返信でどれでも変更できます。返事をしなければ待ち続けます。沈黙をイエスとみなすことはありません。

選んだルートに必要なものをエージェントが確認し、足りないものを、お使いの環境に合ったコマンド1つとともに伝えます。ルートに必要な無料のパッケージやモデル(文字起こし、ステム分離など)は、固定バージョンで自動的にインストールし、納品ノートに明記します。有料のものやアカウントが必要なものは、先に確認します。アイデアと台本には何も必要ありません。LottieにはNodeが必要です。納品するすべての映像には、Node、FFmpeg、ブラウザ、Python 3が必要です。

利用者がすること:Claude Codeでは/ice-motion-director:iceで始まるプロンプトを1つ送り、未決定の項目についての質問に答え(各4択、1回のメッセージで最大4問。プロンプトですべて決まっているか「質問しないで」と伝えれば質問なし)、その場にいれば一度プレビューを確認します。このとき、映像に重ねた本物の音楽の候補を2、3曲聴いて、1曲を選びます(sources.jsonでmusic_optionsを2にしない限り3曲)。実行中は各ステージが2行の報告と静止画で届くので、途中で口を挟むこともできます。裏ではエージェントが複数の補助エージェントとともに10のステージすべてを実行するので、短い広告でもしばらく時間がかかり、チャットの回答よりはるかに多くプランの利用枠を消費します。途中で使用量の上限に達したら、あとで/iceと入力すれば、ice/state.jsonから中断した場所の続きを再開します。

はい。Ice Motion DirectorはApache-2.0のオープンソースです。noncommercial/とvendor/hypit/という名前のフォルダーは、それぞれ中に記載された独自のライセンスに従います。

エージェントにディレクターを

1行を貼り付けたら、作りたい映像を普段の言葉で頼むだけです。Iceがブリーフから納品までを担当し、確認したい段階ではいつでも作業内容を見せます。

npx skills add Omar-Tnzxo/ice-motion-director -g --all
カチンコを開いて「アクション」の合図を待つIce