Communitygithub.com

motion-spot

プロダクト広告、アプリ紹介、ブランドイントロ、ショーリールなど、エージェンシーレベルのモーショングラフィックス動画を100%コードで制作します。HTML、GSAP、CSS 3D、Three.jsを使用し、フレーム単位のレンダリングでリアルなモーションブラー、ナレーション、BGMを実現します。

motion-spot とは?

motion-spotは、コードのみでエージェンシークオリティのモーショングラフィックス動画(スポット広告)を生成するAIエージェントスキルです。Claude Code、Cursor、CodexなどのターミナルベースのAIエージェントで動作し、ユーザーの「スポットを作って」「アニメーション広告」「モーショングラフィックス」といった指示に応じて、10~45秒の洗練された動画を完全コードで制作します。このスキルは、実際に数百万回視聴された45のスポット作品の分析に基づいて設計されており、緊張感のあるコンセプト、実際の製品やインターフェースの忠実な再現、キネティックタイポグラフィ、常に動くカメラワーク、ナレーションと完全に同期したアニメーションなど、効果の実証済みのレシピを実装しています。内部では、GSAPのタイムラインを一時停止した状態でChromeをヘッドレス実行し、1フレームずつ画像を生成、ffmpegでモーションブラーやグレインを適用してMP4に合成します。既存のテンプレートエンジンとサンプルコードが用意されており、ユーザーは参照動画を与えることでそのスタイルや構造を解析・模倣することも、独自のコンセプトから制作を開始することもできます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/santiagosantofimio/motion-spot/tree/HEAD

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

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

ドキュメント

motion-spot は何をしますか?

スタジオ品質のスポット動画を、45本のClaude制作スポット(数百万回再生)の分析から導き出された手法で制作します(references/estudio.md)。すべての作品に共通するレシピは以下のとおりです。

緊張感のあるコンセプト(機能の列挙ではない)+実際のインターフェースや製品を主役に+キネティックタイポグラフィ+決して止まらないカメラ+ナレーションが語る瞬間に合わせたすべての要素+ブランドカラーのピーク+ロゴとコピーによるクリーンな締めくくり。

すべてコードで実現:各フレームはWebページの状態です。GSAPのタイムラインを一時停止し、ヘッドレスChromeで1フレームずつ取得、ffmpegでモーションブラー、グロー、グレインを適用してMP4に変換します。エンジンはplantilla/motor/に構築・テスト済みで、plantilla/escenas.jsに完全なサンプルスポットが含まれています。

ユーザーが参照動画を与えた場合("同じように作って")

  1. デザイン前に参照を分解: キーとなる区間から1秒あたり8~12フレームを適切なサイズで抽出(Readでコンタクトシートを作成)、各要素に注釈:使用されている実際のUI、フォント、色、どのように出現・消滅するか(伸縮、ブラー、反転など)。
  2. 構造と実際の要素をコピーし、「汎用的な代替」は作らない:オリジナルがiMessageの吹き出しを使っていれば、-apple-system(システムのSFフォント)とテール付き吹き出しを使用;Spotifyの歌詞カードなら、ラベル、ボタン、色を再現;巨大な一語ならArial Black(macOS標準)。
  3. タイポグラフィ:決してデフォルトにしない。 ユーザーはClaudeのデフォルトフォント(タイトなネガティブトラッキングの太いサンセリフ、Inter、セリフ斜体)を何度も却下しています。ブランドの実際のSTATICフォント(例:SocialMedia/fuentes/にあるMonaSans-Black/Bold/Regular.ttf、イラスト動画で使用されているもの)を通常のトラッキング(最大-0.01em)で使用するか、参照があればそれを、なければ3つの候補をレンダリング前に表示して確認します。中間ウェイトの変数フォントとタイトなトラッキングは禁止。 3b. デフォルトで「Claudeルック」は禁止:Inter/Anton/セリフ斜体/HUDモノは、参照またはブランドが使用している場合のみ。参照がある場合、タイポグラフィと要素は参照に従います。
  4. 正確に再現できないものは実際のスクリーンショットを依頼(アプリ、プレーヤー、カバーアート):ユーザーはactivos/に配置。Spotifyなど一部のアプリはポリシーにより制御がブロックされている可能性があります:ブロックを回避せず、スクリーンショットを依頼するか、公開画像を使用してその旨を通知します。
  5. 自分のバージョンと参照の比較写真シートを表示し、納品前に差異を修正します。
  6. references/referencia-fiel.mdを参照:完全なプロセス、各要素(Apple Messagesの吹き出し、Spotify歌詞カード、SVGコントロール、スライドするシャドウなど)のレシピ、過去のラウンドで発生したエラー。既製の部品はmotor/ui.jsとmotor/ui.cssに、完全な例はejemplos/video-con-letra/にあります。

開始前の確認事項

不明な点は1つのメッセージにまとめて、提案するデフォルト値とともに質問します:

  1. 何を宣伝するか、誰に向けてか(1行)。
  2. 実際のアセット: ロゴ(SVG推奨)、アプリ・Webのスクリーンショット、商品写真、色。Webサイトも可。アセットがないとブランドが汎用的に見えます:必ず依頼してください。ない場合はサンプル用のアイデンティティをデザインし、その旨を伝えます。
  3. フォーマットと長さ: デフォルトは9:16、15~20秒。WebやYouTubeは16:9。
  4. ナレーション: ElevenLabs(本番用)、say(ドラフト用)、またはナレーションなし。
  5. 音楽: エンジンが作曲、または自分で用意したトラック(公開時推奨)。

ユーザーが完全な依頼を持ち込んだ場合(references/encargo.md)や「決断は任せる」と言った場合、質問せずに制作を開始し、後でDECISIONES.mdで説明します。

フロー

1. プロジェクト

bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot>          # サンプル"Turnito"を参照として使用
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot> --limpio # 空のスケルトン

テンプレートをコピーし、依存関係をインストール(約10秒)、Chromeが利用可能かを確認します。ユーザーのアセットをactivos/にコピーします。

2. コンセプトとアーキタイプ

references/arquetipos.mdを読み、1つ(+ 見せ場のための借用カット)を選びます。以下を作成:

  • 1文のコンセプトとその緊張感:「土曜のカオス vs 3タップで予約する静けさ」。
  • ブランドインサイト:他の誰も使えない、そのブランド独自のディテール(AとZを結ぶAmazonの矢印、画面を切り裂くスウッシュ)。これがないとスポットは汎用的になります。

3. ナレーション脚本 → guion.json

references/voz-y-musica.mdを参照。アニメーションより先にナレーションを書きます。なぜなら、すべてのタイミングを決定するからです。1シーン1フレーズ、2~8語、アクセントと開き記号を含む。状況のフック(「午前2時…」)、アクション、メリット、ピーク、ブランド+コピー。guion.jsonにシーン、BPM、音楽スタイル、picoシーン、エフェクトを記述します。

4. カットプランシート

シーンごとに1行の表:時間・ナレーション・主役・カメラ・モーショングラフィックス技法(3つ以上、references/lenguaje.mdから)・出口トランジション。ルール:

  • 1カットにつき3レイヤー:動く背景+主役+ディテール。
  • カメラは常に動く。モーショングラフィックストランジション(ビートでのカット、ズームスルー、カーテン、アイリス、プッシュ)、フェードは不使用。
  • ブランドカラーか3Dで70%付近にピークを配置。
  • スポット全体で最低8種類の異なる技法を使用。

スポットが長い、またはコストが高い場合、構築前にユーザーにシートを提示します。「作って」と言われたら、そのまま進みます。

5. ビジュアルシステム → estilo.css

references/diseno.mdを参照。変数(--fondo、--tinta、--acento、--acento2...)と、再現するインターフェースのクラスを独自のプレフィックス(.ui ...)で定義。タイポグラフィ:太いサンセリフ+1語のセリフ斜体+HUD用モノ(インストール済み:Inter、Instrument Serif、JetBrains Mono、Anton)。

6. ナレーションとタイミング

  • ElevenLabs:シーンごとに1生成→ audio/voz/<id>.mp3 → node motor/preparar.mjs --recortar。
  • ドラフト:node motor/preparar.mjs --borrador-voz。
  • その後 node motor/preparar.mjs:ナレーションを測定し、カットをビートに量子化し、各単語の推定時間を含むguion.tiempos.jsonを書き出します。

7. シーンごとに構築 → escenas.js

references/motor.md(API、レシピ、既知の落とし穴)を参照。シーンごとに:

  1. spot.escena('id', (capa, c) => { ... })で3レイヤー、カメラの動き、技法を定義。
  2. ナレーションと同期:spot.cuando('id', 'palabra')。
  3. node motor/render.mjs --fotos <inicio+0.1>,<mitad>,<fin-0.1>を実行し、Readでシートを確認(salida/fotos/hoja.jpg)。次に進む前に修正。

plantilla/escenas.js(Turnito)を参考に、オクルージョン、オービット、時計のホイール、通知、ボクセル3D、カーテン、ズームスルーの実装方法を学びます。

8. 音楽とミキシング

node motor/musica.mjs   # BPMに合わせて作曲、"pico"シーンでドロップ;またはguion.jsonの独自トラックを使用
node motor/mezcla.mjs   # ナレーション+音楽(ダッキングあり)+エフェクト、-14 LUFS出力

node motor/servir.mjsでユーザーはプレビューを音声付きで確認し、スクラブできます。

9. レンダリング、レビュー、仕上げ

node motor/render.mjs --fotos                 # 12枚の写真シート:構図、スペル、セーフゾーンを確認
node motor/render.mjs --subida                # 本番:30fps、4倍ブラー、仕上げ、10MB未満のコピーも生成(20秒あたり2~3分)

references/calidad.mdのチェックリスト(3パス)を実行。その後、仕上げ作業のみの1パス:マイクロアニメーション、ビートのアクセント、各シーンの最初と最後のフレームを調整。この2パス目が、良い作品と優れた作品を分けます。

10. 納品

  • salida/spot.mp4 および salida/spot-subida.mp4。
  • サムネイル:最初のフレームではなく、最も印象的な瞬間のフレーム。
  • DECISIONES.md:コンセプト、アーキタイプ、決定事項、破棄したオプション、イテレーション、時間(テンプレートはcalidad.mdにあります)。
  • チャットには:パス、ドラフトであることの明記(sayナレーション、シンセサイズ音楽)、具体的な改善点2~3個。

絶対に破らないルール

  1. すべては時間 t の関数。 Math.random、Date.now、CSSアニメーション、setTimeout、requestAnimationFrameはスポット内で使用禁止。ランダム性が必要な場合はruido(i)またはazar(semilla)を使用。
  2. GSAPでアニメーションする要素のCSSにtransformを決して設定しない(代わりにxPercent/yPercentを使用)。要素の位置ずれの原因第1位。
  3. 各シーンの写真を確認してから次に進む。 確認していないものは納品しない。
  4. 実際のアセットを使用するか、サンプルであることを明示する。 インターフェースはスクリーンショットから忠実に再現し、「汎用的なもの」をでっち上げない。
  5. サードパーティのブランド: ユーザー自身のものでない実際のブランドのスポットはポートフォリオ用の練習作品("spec")です。公式として公開せず、ブランドとの関係を示唆せず、ロゴを変形させない。
  6. データ: ユーザーのものであるか、参考値であることを明示する。
  7. 私は聴覚を持たない。 レベル(ピーク-1~-2dB、-14 LUFS)とナレーションが音楽より明瞭であることを確認し、最終判断はユーザーが聴いて行う。
  8. コンテキスト: スポット制作は多くのコンテキストを消費する。セッションのコンテキスト使用率が40%を超えたら、構築を続ける前にコンパクト化する。
  9. 歌詞: Claudeはどこにも(コード、letra.json、チャット)歌詞を書きません。ユーザーが渡した場合も同様です。歌詞付き動画の場合:テキストを空にしたletra.jsonでタイミングを設定、歌詞があってもなくても動作するスポット、ニュートラルなフレーズでテスト用コピーを検証、そしてユーザーが歌詞を貼り付けて最終レンダリングを実行。詳細はreferences/motor.md → "letra.json"を参照。

ミュージックビデオおよび背景動画

node motor/extraer.mjs <video> --desde S --hasta Sでフレーム(activos/clip/)と該当区間の音声を抽出;videoCuadros(...)で同期表示;motor/letra.jsがletra.jsonからカラオケを生成。アーキタイプ9はreferences/arquetipos.mdを参照。

問題発生時の対応

症状考えられる原因
window.spot.listoがtrueにならないescenas.jsのJSエラー:レンダラーがページのエラーを出力。インポートとawait spot.terminar()の存在を確認
要素がずれて表示される、またはジャンプするCSSとGSAPの両方にtransformがある;または別のクラス(.app)と衝突;または子孫セレクタの範囲が広すぎる
シーンが白または黒で表示されるidが脚本にない(preparar.mjsを実行)、またはトランジションがレイヤーをopacity: 0のままにしている
3Dが平面的に見える中間コンテナにtransform-style: preserve-3dがない、または途中にoverflowやfilterがある
ナレーションと映像が合わないspot.cuando(...)を±0.1秒調整;servir.mjsで音声付きで確認
レンダリングに時間がかかるドラフトでは--blur 1 --escala 0.5を使用;シャドウやブラーのノード数を減らす;voxelOlaやparticulasのnを減らす
MP4ファイルサイズが大きいグレインが原因:--grano 3または--crf 22;アップロード用は--subida

関連スキル