Communitygithub.com

cskwork/motion-graphics-skill

コード駆動のモーショングラフィックス動画を、HTMLからフレーム精度で再現可能に作成します。製品ローンチ動画やフィーチャーアナウンス、YouTube Shorts/Reels/TikTok用の縦型ショート動画などに対応。

motion-graphics-skill とは?

このスキルは、HTML、ヘッドレスChromium、ffmpegを組み合わせて、フレーム精度で再現可能なコード駆動型モーショングラフィックス動画を生成します。動画の全ピクセルは時間 `t` の純粋関数として表現され、各フレームがレンダリングされます。製品ローンチ、プロモーション、アプリトレーラーなどの横型長編動画と、YouTube Shorts、Reels、TikTok向けの縦型ショート動画の2つのフォーマットをサポート。シニアモーションデザイナーのショーリール品質を目標とし、単なるスライドショーを避けます。スキルは、フォーマットの選択、作業フォルダのセットアップ、`MG.*` ヘルパーを使ったコンポジション作成、レンダリング、オーディオミックス、QAチェックまでの全工程を詳細にガイドします。各動画は毎回独自のアイデア、スクリプト、ルックで制作され、決定論的なレンダリングのために `Math.random` などの非決定論的要素の使用を禁止します。最終的には、フレーム精度のスチル確認、フルレンダリング、オーディオミックス、品質チェックを経て、最終的なMP4ファイルを納品します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

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

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

ドキュメント

motion-graphics

動画は、全ピクセルが時間 t の純粋関数である1つのHTMLページであり、ヘッドレスChromiumでフレームごとにレンダリングされ、ffmpegでエンコードされます。目標はシニアモーションデザイナーのショーリール品質であり、決してスライドショーではありません。

1. フォーマットを選択

依頼内容参照ファイル
実際の製品のローンチ、プロモーション、コマーシャル、フィーチャーリール、アプリトレーラーformats/launch-video.md
Shorts、Reels、TikTok、縦型説明動画やストーリーformats/shorts.md

フォーマットファイルに従い、ブリーフ、コンテンツ手順、ビート構造を確認してください。その後、ビルドのためにここに戻ってきます。また、コンポジションを作成する前に references/pitfalls.md も読んでください。

毎回新しいコンセプトで作成。 各動画には独自のアイデア、スクリプト、ルックがあります。ユーザーが過去の作品を参照しないように指示した場合は、以前の動画やコンポジションをワークスペースで開かないでください。

2. 作業フォルダ

ユーザーが希望する場所(デフォルトはカレントディレクトリ)に <slug>-<YYYYMMDD>/ を作成します:

brief.md          フォーマットのブリーフテーブルからのパラメータ
beats.md          ビートシート(時間、コピー、アセット、動き、トランジション、アクセントヒット)
assets/           キャプチャ、画像、フォント、オーディオ
assets/manifest.md  アセットファイルごとに1行:ソース、ライセンスまたは「<サーフェス>からキャプチャ」、表示内容
motion.html       コンポジション
motion.json       {"size": [W, H], "fps": 60, "duration": 30, "stills": [ビート時間], "captions": []}
engine/           このスキルの engine/ からコピー
out/              スチル、レンダリング、コンタクトシート

フォルダごとに一度だけエンジンをセットアップします:

cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. コンポジション

motion.html は engine/runtime.css と engine/runtime.js をロードし、DOMを構築し、シーンを登録して、MG.ready() を呼び出します。

ヘルパー使用法
MG.scene(start, end, fn, el)fn(local, t, dur) は start <= t < end の間実行されます。el は範囲外では非表示になります。アニメーションするプロパティはすべての呼び出しで設定します。
MG.always(fn)毎フレーム実行:背景、グレイン、プログレスバーなど。
MG.prog(t, a, b, ease)イージングされた0..1の進行度。イージング:MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) または任意の関数。
MG.tween(t, [[t0, v0], [t1, v1, ease], …])キーフレーム。値は配列でも可。
MG.spring(t, {stiffness, damping})オーバーシュートを伴う物理的な0→1。
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})要素ごとにフレームごとに1回呼び出し。
MG.clip(videoEl, start, rate)start からフレーム精度でスクリーンレコーディングを再生。
MG.rng(seed), MG.noise(x, seed)決定論的な乱数と揺らぎ。
MG.fmt(n, {decimals})カウンター用のロケール数値書式設定。
MG.captions()motion.json のキャプションを下部UIブロックの上に描画。

決定論:レンダリングロジック内で Date、performance.now()、requestAnimationFrame、Math.random を使用しないでください。CSS @keyframes は許可されています。ランタイムは t でそれらを一時停止するため、animation-delay でタイミングを合わせてください。マニフェストにリストされているフォントと画像のみを使用してください。

フレームのプレビュー:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(ガイドはセーフゾーンを表示)。リアルタイム:?play=1。キャプションはレンダリング時のみ表示されます。

4. クラフト基準

  • フレーム0はすでに動いている。 黒からのフェードイン、ロゴのイントロはなし。
  • 0.8~2秒ごとに、レイアウト、スケール、色、数字、またはカメラに意味のある変化がある。
  • エントランスにはスプリングまたはイーズアウトエクスポを使用し、わずかにオーバーシュートさせる。30~60 msのずらし。リニアはティッカーだけ。
  • 速い動きのときのみモーションブラー。ホールドショットではスロープッシュ(スケール 1 → 1.04)。2~3のデプスレイヤーでパララックス。
  • 背景ファミリーは1つ、テキストカラーは1つ、アクセントは1つ。フラットフィルがアップロード後にバンディングしないように、グレインまたはグラデーションノイズを追加。
  • コピーは2回読める時間画面上に残す。主要テキストはセーフゾーン内に収める。
  • ビートは音と同期:各変化にウーッシュ、ヒット、または音楽のビート。

5. レンダリング

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

まずスチルでレイアウトを確定します:ビートごとに1枚、各トゥイーン内に1枚、各スプリングのオーバーシュートピークに1枚。1回のフルレンダリングを実行します(1080p60、4ワーカーで25秒間で約10分)。

6. オーディオ

マニフェストにリストされ、使用を許可するライセンスがある音楽とSFXのみを使用するか、ユーザーが提供するファイルを使用します。それらがない場合は、無音で納品し、その旨を伝えます。キューミックスしてから、マルチプレックス:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

統合ラウドネスは約−14 LUFS、トゥルーピークは−1 dBFS以下を目標にします。SFXは約−6~−14 dB、音楽は−14~−18 dB。画面上のテキストの下の音楽はインストゥルメンタルにします。

7. QA

  1. ffprobe で、長さ、サイズ、fpsがブリーフと一致していることを確認。
  2. コンタクトシート:ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。各ビートチェンジで、コンタクトシートとフルサイズのフレームを確認(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。
  3. すべてのフレーム:エッジでクリップされていない、空白または半ばフェードしたフレームがない、ガイドの残骸がない、誤字やプレースホルダーテキストがない、2秒以上静止しているものがない。
  4. フォーマットファイル独自のチェック。

すべてのチェックがパスするまで修正と再レンダリングを繰り返します。新しい教訓があれば、スキルの references/pitfalls.md に 日付 · 動画 · 教訓 の形式で追加します。

納品

最終的なMP4のパス、長さ、サイズ、fps、表示内容、必要なクレジットを含むオーディオステータス、再レンダリングコマンドを報告します。作業フォルダは保持します。アップロードまたは投稿はユーザーから依頼があった場合のみ行います。

関連スキル