motion-spot は何をしますか?
スタジオ品質のスポット動画を、45本のClaude制作スポット(数百万回再生)の分析から導き出された手法で制作します(references/estudio.md)。すべての作品に共通するレシピは以下のとおりです。
緊張感のあるコンセプト(機能の列挙ではない)+実際のインターフェースや製品を主役に+キネティックタイポグラフィ+決して止まらないカメラ+ナレーションが語る瞬間に合わせたすべての要素+ブランドカラーのピーク+ロゴとコピーによるクリーンな締めくくり。
すべてコードで実現:各フレームはWebページの状態です。GSAPのタイムラインを一時停止し、ヘッドレスChromeで1フレームずつ取得、ffmpegでモーションブラー、グロー、グレインを適用してMP4に変換します。エンジンはplantilla/motor/に構築・テスト済みで、plantilla/escenas.jsに完全なサンプルスポットが含まれています。
ユーザーが参照動画を与えた場合("同じように作って")
- デザイン前に参照を分解: キーとなる区間から1秒あたり8~12フレームを適切なサイズで抽出(Readでコンタクトシートを作成)、各要素に注釈:使用されている実際のUI、フォント、色、どのように出現・消滅するか(伸縮、ブラー、反転など)。
- 構造と実際の要素をコピーし、「汎用的な代替」は作らない:オリジナルがiMessageの吹き出しを使っていれば、
-apple-system(システムのSFフォント)とテール付き吹き出しを使用;Spotifyの歌詞カードなら、ラベル、ボタン、色を再現;巨大な一語ならArial Black(macOS標準)。 - タイポグラフィ:決してデフォルトにしない。 ユーザーはClaudeのデフォルトフォント(タイトなネガティブトラッキングの太いサンセリフ、Inter、セリフ斜体)を何度も却下しています。ブランドの実際のSTATICフォント(例:
SocialMedia/fuentes/にあるMonaSans-Black/Bold/Regular.ttf、イラスト動画で使用されているもの)を通常のトラッキング(最大-0.01em)で使用するか、参照があればそれを、なければ3つの候補をレンダリング前に表示して確認します。中間ウェイトの変数フォントとタイトなトラッキングは禁止。 3b. デフォルトで「Claudeルック」は禁止:Inter/Anton/セリフ斜体/HUDモノは、参照またはブランドが使用している場合のみ。参照がある場合、タイポグラフィと要素は参照に従います。 - 正確に再現できないものは実際のスクリーンショットを依頼(アプリ、プレーヤー、カバーアート):ユーザーは
activos/に配置。Spotifyなど一部のアプリはポリシーにより制御がブロックされている可能性があります:ブロックを回避せず、スクリーンショットを依頼するか、公開画像を使用してその旨を通知します。 - 自分のバージョンと参照の比較写真シートを表示し、納品前に差異を修正します。
references/referencia-fiel.mdを参照:完全なプロセス、各要素(Apple Messagesの吹き出し、Spotify歌詞カード、SVGコントロール、スライドするシャドウなど)のレシピ、過去のラウンドで発生したエラー。既製の部品はmotor/ui.jsとmotor/ui.cssに、完全な例はejemplos/video-con-letra/にあります。
開始前の確認事項
不明な点は1つのメッセージにまとめて、提案するデフォルト値とともに質問します:
- 何を宣伝するか、誰に向けてか(1行)。
- 実際のアセット: ロゴ(SVG推奨)、アプリ・Webのスクリーンショット、商品写真、色。Webサイトも可。アセットがないとブランドが汎用的に見えます:必ず依頼してください。ない場合はサンプル用のアイデンティティをデザインし、その旨を伝えます。
- フォーマットと長さ: デフォルトは9:16、15~20秒。WebやYouTubeは16:9。
- ナレーション: ElevenLabs(本番用)、
say(ドラフト用)、またはナレーションなし。 - 音楽: エンジンが作曲、または自分で用意したトラック(公開時推奨)。
ユーザーが完全な依頼を持ち込んだ場合(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、レシピ、既知の落とし穴)を参照。シーンごとに:
spot.escena('id', (capa, c) => { ... })で3レイヤー、カメラの動き、技法を定義。- ナレーションと同期:
spot.cuando('id', 'palabra')。 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個。
絶対に破らないルール
- すべては時間
tの関数。Math.random、Date.now、CSSアニメーション、setTimeout、requestAnimationFrameはスポット内で使用禁止。ランダム性が必要な場合はruido(i)またはazar(semilla)を使用。 - GSAPでアニメーションする要素のCSSに
transformを決して設定しない(代わりにxPercent/yPercentを使用)。要素の位置ずれの原因第1位。 - 各シーンの写真を確認してから次に進む。 確認していないものは納品しない。
- 実際のアセットを使用するか、サンプルであることを明示する。 インターフェースはスクリーンショットから忠実に再現し、「汎用的なもの」をでっち上げない。
- サードパーティのブランド: ユーザー自身のものでない実際のブランドのスポットはポートフォリオ用の練習作品("spec")です。公式として公開せず、ブランドとの関係を示唆せず、ロゴを変形させない。
- データ: ユーザーのものであるか、参考値であることを明示する。
- 私は聴覚を持たない。 レベル(ピーク-1~-2dB、-14 LUFS)とナレーションが音楽より明瞭であることを確認し、最終判断はユーザーが聴いて行う。
- コンテキスト: スポット制作は多くのコンテキストを消費する。セッションのコンテキスト使用率が40%を超えたら、構築を続ける前にコンパクト化する。
- 歌詞: 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 |