Communitygithub.com

Motion — コードでモーショングラフィックスを生成

HTML/Canvas コードでモーショングラフィックスを記述し、Playwright + ffmpeg でフレームごとにレンダリングして MP4 を作成します。ブランドキット、テクニックライブラリ、フレームシートレビューによる厳格なワークフローで、ピクセルパーフェクトな動画を提供します。

Motion — コードでモーショングラフィックスを生成 とは?

このスキルは、**コードでモーショングラフィックス動画を制作する**ためのものです。HTML/Canvas 上でアニメーションを記述し、Playwright と ffmpeg を使ってフレームごとにレンダリングすることで、正確な色、フォント、数値を持つ MP4 動画を生成します。主なワークフローは、ブランドキットの作成 → 6つのコンポーネントのトリアージ → タイムコード付きスクリプトの承認 → テンプレートへの実装 → フレームシートレビュー → レンダリングと納品、という流れです。対応プラットフォームは Claude Code (CLI エージェント) を想定しており、Python、Playwright、ffmpeg が実行できる環境が必要です。このスキルは、ブランドのガイドラインに厳密に従い、数値データやフォントを正確に表現する必要があるリール動画、広告、ロゴアニメーションに特に有効です。物理シミュレーションやシェーダーなどの高度なテクニックにも対応していますが、実写撮影やフォトリアリスティックな画像生成、AI による画像からの動画生成は行いません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/motion

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

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

ドキュメント

コードでモーション制作

動画はコードから生まれます。 私は、t クロックに基づいて各フレームを描画するプログラムを書き、フレームごとにレンダリングして MP4 にまとめます。そのため、16進数の色、ブランドフォント、数値はすべて正確に出力されます。これらはコードに直接書かれているものであり、生成 AI によって解釈されたものではありません。また、「30% 遅く」や「9:16 に変更」といった修正は、動画を最初から作り直すことなく、コードの1行を変更するだけで対応できます。

対応しないこと: 人物、場所、製品の撮影。ゼロからのフォトリアリスティックな画像生成。ブランドの推測。写真、動画、ブランドの実際の画面はファイルとして提供され、コードは提供されたものをアニメーション化します。

ベースとなる実写動画は、<video> タグではなく、フレームシーケンスとして取り込みます。 ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg でフレームを書き出し、draw 内で floor(t × fps) + 1 のフレーム画像をオンデマンドで読み込みます。<video> タグを使用すると、レンダリングサーバーが Range リクエストに応答せず(シークが機能しない)、メディア接続が適切に閉じられないため(networkidle がタイムアウトする)問題が発生します。

必要条件: Python 3.10+、pip install playwright + playwright install chromium(スクリプトは chrome チャンネルを使用します。Chrome がインストールされていない場合は、abrir() 内でデフォルトの Chromium に変更してください)、ffmpeg および ffprobe が PATH に含まれていること。

このスキルのファイル:

  • assets/template.html: ユニーククロック、固定シード、イージング、ステガー、タイムラインバーとシーン名付きプレイヤー、セーフエリアを備えたエンジン。
  • scripts/render.py: フレームごとに MP4 をレンダリングし、ショートバージョン用のセグメント、レビュー用のフレームシートを生成します。
  • tecnicas.md: 7グループに分類された39のテクニックと、各テクニックのパラメータ、目的別の組み合わせ。
  • examples/reel-resultado-8s.html: 完成した8秒のリール動画の例(数字シャッフル → バー → CTAと紙吹雪)、サンプルデータ付き。

作業ディレクトリ: 動画ごとに1つのディレクトリ(例: motion/<client>/<piece>/)。HTML、アセット(ロゴ、写真、フォント)、MP4、レビューシートはすべて同じ場所に置かれます。


ステップ 0 — ブランドキット

ブランドごとに一度だけ、マニュアル、ウェブサイト、またはクライアントから提供された情報に基づいてキットを作成します。

アイテム入力方法
パレット背景、テキスト、アクセント、数字の16進数カラーと役割。3〜4色。7色は色が多すぎてコントラストが不足します。
フォント正確なフォント名。Google Fonts → <link>。独自フォント → フォルダにファイルを配置し、@font-face を使用。
ロゴファイル(SVG または透明 PNG)。ロゴをゼロから描画したり、言葉で説明したりしないでください。ファイルがなければ、提供を依頼してください。
動きのトーン2〜3の形容詞(落ち着いた、エネルギッシュ、プレミアム、ポピュラー)。イージングとカットを定義します。
数字実際の値、小数点、フォントを含む。確認済みの数字がない場合 → 私が確認するか、画面上に 「サンプルデータ」 とラベルを付けて表示します。
オファー、CTA、@/サイトブリーフから。緊急性を出すのは、実際の期限がある場合のみ。
トラックブランドまたはストックサイトからライセンスされたファイル + BPM とドロップの秒数。

ブランドフォルダにキットを motion.md として保存します。2つ目の動画以降は、このファイルを読み込み、再作成は行いません。

ステップ 1 — トリアージ: 6つのコンポーネント

以下のチェックリストを一度に1つの質問ずつ埋めていきます。一度埋めた項目は再度開きません。ブリーフにすでに答えがある項目は、最初から埋めた状態で表示します。コンポーネントが不足している場合は、私が単独で決定しますが、ほとんどの場合、クライアントが想定していたものとは異なります。

1. フォーマット — アスペクト比 + 解像度 + 尺 + fps
2. シーン — 何が、どの順序で、各シーン何秒表示されるか
3. テキスト — 正確なフレーズを引用符で囲んで(クローズドリスト、リテラル)
4. テクニック — 名前を指定(tecnicas.md)
5. リズムと音 — イージング、ステガー、BPM / トラック
6. 納品形式 — MP4 · 6秒のショートバージョン · レビュー用プレイヤー · LP用ループHTML · 透明背景

プラットフォーム別フォーマット:

アスペクト比解像度配置場所標準尺
9:161080×1920Reels, Stories, TikTok, Shorts8〜15秒、最初のフレームにフック
4:51080×1350IG/FB フィード6〜15秒
1:11080×1080フィード、一部の配置6〜15秒
16:91920×1080YouTube、プレゼンテーション、大画面、ウェブサイト5秒(イントロ)から長尺説明まで
LPページ幅(例: 1440)ヒーローセクションなど軽量な5〜10秒ループ、HTMLで納品

30 fps でほぼすべてカバーできます。60 fps は、ズーム、高速パーティクル、カメラの動きがある場合のみ必要です。広告の場合は、テスト用に常に同じ内容の6秒バージョンを作成します。

ステップ 2 — タイムコード付きスクリプト(ゲート)

コードを書く前に、スクリプトを表示して承認を待ちます:

フォーマット: 9:16 · 1080×1920 · 15秒 · 30 fps · トラック 120 BPM(カット: 3 / 7 / 11秒)
キット: 背景 #050505 · アクセント #E50914 · 数字 #FFDD00 · Morganite / IBM Plex Sans · logo.svg

| シーン | 時間 | テクニック | 内容 | テキスト(リテラル) | 入場 / 退場 |

スクリプトのルール:

  • シーンは1つのアイデアにつき1つ。 1つのシーンに2つのフレーズが必要な場合は、2つのシーンに分割します。
  • 各シーンは2〜4秒。 2秒未満では、テキストを読む時間が足りません。
  • 読み取り時間: 単語3語につき1秒 + 1秒のマージン。数字のみ: 1.5秒 · 3語: 2秒 · 6語: 3秒 · 9語: 4秒。4秒以上かかるフレーズは1つのシーンとして長すぎるので、分割するか単語を削ります(承認済みコピーの単語を削る判断は、承認者のみが行います)。
  • 入場と退場の方法を指定します。 退場は次のシーンへのつながりとなります。
  • 9:16 と 4:5 では、最初の3秒間にフックを配置します。 メインメッセージは最後に残してはいけません。
  • ビートに合わせてカット: ビート = 60 ÷ BPM 秒。小節 = 4ビート。シーンの尺が小節の倍数になると、動画が引き締まります(120 BPM: ビート 0.5秒、小節 2秒 · 128: 0.47 / 1.88 · 100: 0.6 / 2.4 · 90: 0.67 / 2.67)。

ステップ 3 — 構築

assets/template.html を作業ディレクトリにコピーし、CFG、BRAND、SCENES を埋めます。コードの法則は、これらによって MP4 がプレイヤーで承認されたものと一致することが保証されるため、重要です。

  1. すべては t の関数です。 setTimeout、Date.now()、CSS トランジション/アニメーション、またはフレーム間で状態を蓄積するものは使用禁止。1.4秒の時点での文字「3」は、常に同じ位置にあります。
  2. すべてのランダム値には固定シード(rng(CFG.SEED + i))を使用します。これがないと、エクスポート結果が承認結果と異なります。
  3. シミュレーション(物理、ボイド、布): t に関する解析式を使用するか、ロード時に固定ステップ(1/240秒)で事前計算し、フレームごとに保存してインデックスで読み取ります。draw 内で積分してはいけません。
  4. フォントは CFG.FONTS、アセットは CFG.ASSETS に配置します。エンジンは最初のフレームの前にこれらがロードされるのを待ちます。ロードされなかったフォントは、警告なしで汎用フォントにフォールバックします。これは最もよくあるエラーです。
  5. 9:16 のセーフエリア: テキスト、数字、ロゴは、上端から250px、下端から350px、右端から120px、左端から60px以内に配置します(概算値。アプリによって異なります)。
  6. 意図を持ったイージング: inOut がデフォルト。テキスト、ピン、数字の登場には back(オーバーシュート)を使用。linear は連続回転とスクロールのみに使用。bounce は落下するオブジェクトのみに使用。ステガーは文字間 0.07秒、カード間 0.15秒。
  7. 階層: 主要な数字は、シーン内で最も大きな要素にします。
  8. 各シーンの先頭に、時間とテクニックをコメントとして記述します。

長尺動画や負荷の高いテクニック(シェーダー、シミュレーション)を使用する場合: シーンごとに1つずつ構築します。シーンを構築し、レビューし、承認を得てから統合します。短尺動画(〜15秒、軽量な4シーン程度)は全体を一度に作成できますが、レビューは引き続きシーンごとに行います。

ステップ 4 — 公開前のレビュー

python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe

各シーンの中間と最後のフレームを、セーフエリアを表示したシートを生成します。以下の方法でシートを確認します: 確認 → 拡大 → 確定(小さなテキスト、数字、ロゴの拡大部分を確認)。6つのレイヤーをチェックします:

レイヤー確認内容
1. テクニック尺、解像度、fps がリクエスト通りか。先頭または末尾に黒フレームがないか。
2. ブランド16進数カラーが正しいか。ブランドフォントがロードされ、汎用フォントになっていないか。ロゴに歪み、回転、色の置き換えがないか。動きのトーンが適切か。
3. 可読性シーンごとに1つのアイデアか。各テキストはルールに従った時間表示されているか。テキストと背景のコントラストは十分か。主要な数字が最も大きいか。
4. プラットフォームアスペクト比が正しいか。セーフエリア外に要素がないか。最初の3秒にフックがあるか。音声なしでも機能するか。
5. データ数字は提供されたものと一致しているか(四捨五入なし)。ピリオドとフォントは正しいか。サンプルデータは画面にラベル表示されているか。捏造された数字がないか。
6. 権利トラックはライセンスされているか、ブランド所有か、生成されたものか。写真や画面は許可を得ているか。第三者のブランドは許可がある場合のみ使用。オファーの約束は検証済みか。

特定の瞬間を確認する場合: --sheet 1.5,2.9,3.1。問題が見つかった場合は、質問せずに公開前に修正します。

素材の3回目の確認は、承認者がスマートフォンで、音声なしで行うものです。 私はフレームを確認しますが、動画が再生されているときの感覚は確認しません。納品時には、明示的にこの確認を依頼してください。

ステップ 5 — レンダリングと納品

python ~/.claude/skills/motion/scripts/render.py peca.html                                   # MP4全体
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4   # ショートバージョン
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3                # トラック付き

レンダリング後: ffprobe で解像度、fps、フレーム数、尺を確認します。納品物:

  • MP4(H.264, yuv420p, +faststart)、そのままアップロード可能。
  • 6秒バージョン(広告の場合)。
  • プレイヤー付きHTML(ブラウザで開く: 再生、一時停止、タイムラインバー、シーン名、セーフエリア)。承認者はこれを使用して、調整が必要な正確な秒数を指定します。

LP: 納品はループするHTML自体であり、MP4は含みません。軽量性が最優先です。ページの読み込みを遅くしてはいけません。

トラック: スキルはファイルをミックスし(--audio)、カットを指定されたBPMに合わせます。コードで生成されたトラックは実装されていません。リクエストがあった場合は、即興で対応せず、その旨を伝えてください。ライセンスのない第三者の音楽は広告を停止させるため、絶対に使用しないでください。

ステップ 6 — 調整

最初のバージョンはドラフトです。適切な調整は、シーンまたは秒数を指定し、変更量を指定し、保持すべきものを指定します。「シーン1(0〜3秒)で、+248% を1.5秒間固定してから切り替えてください。残りは変更しないでください。」影響を受ける部分のみを変更し、再レンダリングします。

症状考えられる原因修正
ロボットのような動きlinear イージングinOut、登場時は back を使用
すべてが同時に動くステガーがない文字間 0.07秒、カード間 0.15秒のステガーを追加
ブランドフォントと異なるフォントがロードされていないCFG.FONTS / @font-face とフォルダ内のファイルを確認
9:16 でテキストが切れる16:9 を想定したレイアウト1080×1920 のグリッドでセーフエリアを考慮して再作成
プレイヤーがカクつくパーティクルやシェーダーが多すぎるプレイヤーでは要素を減らし、フルカウントはレンダリング時のみにする
エクスポート結果がプレイヤーと異なるシードなしのランダム、または状態の蓄積ステップ3の法則1〜3に従う
ビートから外れたカットシーンがBPMと関係ない尺をビートの倍数にする
数値が間違っているデータが提供されていない提供されたリストを正確に使用し、四捨五入しない

公開後: リテンション低下が最初の3秒にある場合、シーン1のみを交換します。中間のシーンにある場合、そのシーンのみを短縮または交換します。クリックが発生しない場合は、他の部分はそのままに、異なるエンディング(紙吹雪、回転するシール、QRコード)をテストします。一度に変更する変数は1つだけです。

アカウントライブラリ

承認された動画 → ブランドの motion.md に記録: 承認されたスクリプト、使用されたテクニック、HTML のパス、および可能であれば最初の7日間のメトリクス。次の動画は、過去に実績のあったものから始め、ブランドの標準エンディング(ロゴ + CTA 付きの最終署名)は再利用され、再作成されません。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル