Communitygithub.com

モーションパイプライン (motion-pipeline)

生のフッテージとスクリプトから、完成度の高いノンスロップな動画編集を行うためのエンドツーエンドのランブックです。ステージ順序、品質ゲート、ディスク上のアーティファクト構成、エンジン選択、並列ショット構築、出荷チェックリストを網羅しています。「この動画を編集して」「動画を作って」「モーショングラフィックスを追加して」「この編集をワンショットで」といった、単一のアニメーションを超えるリクエストがあった場合、最初に使用するスキルです。motion-plan、motion-assets、motion-design、motion-animate の各スキルを順次実行します。編集全体が対象となる場合は、これらのスキルをアドホックに実行しないでください。

モーションパイプライン (motion-pipeline) とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が動画編集プロジェクトをゼロから高品質に仕上げるための、厳格なステージベースのオーケストレーションパイプラインを定義します。編集を単一のショットまたはワンショットで完了しようとする代わりに、インテーク、トランスクライブ、プランニング、アセット準備、デザイン、アニメーション、バッチ処理、統合の8つのステージを順番に実行することを強制します。各ステージには明確な品質ゲート(G0~G7)があり、ゲートを通過しない限り次のステージに進むことはできません。これにより、AIにありがちな「スロップ(手抜き)」な出力を防止します。具体的には、パレットの一貫性、密度の制限、モーションのチェックリスト、出荷前の総合チェックなど、プロジェクト全体の品質を保証するための詳細なルールとアーティファクト構成が定義されています。このスキルは、Remotion、HyperFrames、Manim、After Effects、Blenderなど、さまざまなレンダリングエンジンをサポートし、エージェント間で共有されるトークンCSSファイルにより全ショットのビジュアル一貫性を維持します。さらに、ユーザーの修正履歴をプロジェクトスキルとして保存することで、次回以降の編集を効率化する継続的改善ループも提供します。

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

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

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

ドキュメント

motion-pipeline

あなたはオーケストレーターであって、アニメーターではありません。あなたの仕事は、ステージを順番に実行し、失敗したゲートを通過せず、すべてのショットを他のすべてのショットと一貫性を保つことです。

AI編集がスロップ(手抜き)に見える唯一の原因は、ステージをスキップすることです。 計画的でないビートに、でっち上げたパレットで、誰も再グレーディングしていないストックアセットを使って素晴らしいアニメーションを作っても、それはスロップです。順序は努力に勝ります。

非交渉事項

  1. フル動画を決してワンショットで作成しないでください。 ショット1を出荷品質に仕上げ、承認を得てから、残りをそれに合わせてバッチ処理してください。26シーン後にスタイルが却下されると、26回の書き直しになります。
  2. 赤いゲートを決して通過しないでください。 どのゲートが失敗したか、何が欠けているかを言及してください。
  3. フッテージ、ブランドキット、または参照フォルダが提供できる場合、パレット、フォント、またはアセットを決して発明しないでください。
  4. すべての行を決して装飾しないでください。 密度はステージ2で上限が設定され、出荷時に強制されます。
  5. すべての決定はディスクに書き込まれ、コンテキストに保持されません。 次のエージェント、次のセッション、そしてユーザーはすべて同じファイルを読み取ります。

ステージマップ

#ステージスキル / ツール通過すべきゲート
0インテーク本スキルG0 ブリーフ完了
1トランスクライブwhisper / hyperframes transcribe / Premiere テキストパネルG1 単語レベルのタイミングが存在する
2プランニングmotion-planG2 すべてのビートが分類され、密度が上限以下
3アセットmotion-assetsG3 パレットがサンプリングされ、トークンが書き込まれ、プレースホルダーゼロ
4デザインmotion-designG4 パイロットフレームのアンチスロップパス
5アニメートmotion-animateG5 パイロットショットのモーションパス
6バッチ並列サブエージェントG6 すべてのショットがパイロットと一致する
7統合Premiere / マスタータイムラインG7 出荷チェックリスト(付録A)

ステージ0 — インテーク

何かに触る前に収集します。本当に欠けているものだけを尋ね、残りは推測し、その推測を述べてください。完全なブリーフ用、薄い場合のデフォルト、ステージ6でサブエージェントに送信するメッセージのテンプレートは付録Bにあります。

  • フッテージ パス、解像度、fps、および既にカットされているかどうか。
  • スクリプトまたはトランスクリプト、およびタイミングが存在するかどうか。
  • アスペクト比 — 16:9、9:16、1:1。これはトリミングだけでなく、構図も変更します。
  • 目標再生時間 と厳しい締め切り。
  • ブランドキット — ロゴファイル、フォント、16進数コード、一致させる以前の動画。存在しない場合は、そのように述べ、ステージ3でフッテージから導出します。
  • 参照リンク — 最も効果の高い単一のインプットです。3つの参照は、3段落の説明に勝ります。名前を指定して依頼してください:「あなたが望むルックの動画またはスクリーンショットを2~3つ送ってください。」
  • エンジン制約 — 成果物をPremiere/After Effectsに取り込む必要があるか、スタンドアロンレンダリングで問題ないか。

edit/BRIEF.md を書き込んでください。参照がない場合は、その旨をフラグしてください:参照が提供されていないため、スタイルはフッテージから導出され、ユーザーがショット1に反応するまで推測のままです。

アーティファクト構成

ステージ1の前にこれを作成してください。下流のすべてがここで読み書きします。重要なものはチャット内にのみ存在することはありません。

edit/
  BRIEF.md            インテーク + 推測 + 制約
  NOTES.md            実行ログ: すべてのユーザー訂正、逐語的に
  00-source/          生のAロール、音楽、SFX、ブランドキット
  01-transcript/      words.json (単語レベル)、transcript.md
  02-plan/            plan.md + plan.json (機械可読なショット行)
  03-assets/
    brand/            logo.svg、fonts/、brand.json
    refs/             スタイル参照。何を教えてくれるかで名前付け
    gen/              AI生成の静止画/動画。プロンプト.txtを各ファイルの隣に
    3d/               glb/obj + レンダーパス
    lottie/           .json / .lottie
    sfx/              ウィッシュ、インパクト、UIクリック
  04-design/
    tokens.css        パレット + タイプスケール — 唯一の信頼できる情報源
    palette.json      機械可読、ジェネレーター用
    pilot/            承認済みショット1のフレーム
  05-scenes/          ショットごとに1フォルダ: 03-stat-card/、07-map/、...
  06-renders/         ショットごとのmp4(不透明)/ mov prores4444(アルファ)
  07-master/          プロジェクトファイル + 最終書き出し

tokens.css は法律です。 すべてのシーンがそれをインポートします。色をハードコードするシーンはバグです。他のシーンから逸脱するからです — ショット間のパレットのずれは、構造的なスロップの最も顕著な兆候です。

ステージ1 — トランスクライブ

単語レベルでなければカウントされません。フレーズレベルのタイミングは均一な長さのビジュアルを生成し、自動化されたように見えます。

  • ローカル: whisper(最終版には large-v3、スクラッチパスには base)または npx hyperframes transcribe。
  • 既にPremiere内: テキストパネルのトランスクリプトはタイミング付きで書き出せます。
  • 既にYouTube上: キャプショントラックを取得します。

01-transcript/words.json を {word, start, end} レコードで出力します。

G1 — 文レベルのタイミングしかない場合は失敗します。プランニングの前に修正してください。推定しないでください。

ステージ2 — プランニング

motion-plan を呼び出します。各ビートを VISUAL または REST に分類し、各ビジュアルが何を示す必要があるかを書き込みます。

さらに、パイプラインの密度上限を適用します:

動画の長さ最大VISUAL割合典型的なショット数
60秒未満(ショート)65%8–14
3–8分40%15–30
8–20分30%25–50
20分以上22%40–80

また、plan.json を出力します — ショットごとに1行:{id, start, end, dur, text, must_show, archetype, engine, assets[]}。ステージ6はこれらの行にファンアウトするため、各行は周囲の会話なしで独立していなければなりません。

G2 — ビートが未分類の場合、密度が上限を超えている場合、または隣接する2つのショットが同じアーキタイプを使用している場合(単調さはテンプレートのように見えます)に失敗します。

ステージ3 — アセット

motion-assets を呼び出します。2つの出力が重要です:

  1. 04-design/tokens.css — フッテージからサンプリングされたパレットであり、発明されたものではありません。
  2. plan.json 内のすべての assets[] エントリが、ディスク上の実際のファイルに解決されます。

G3 — プレースホルダー、ロレム・イプサム、「TODO: アイコンを検索」、パレットにまだ再グレーディングされていないストックアセットがある場合に失敗します。

ステージ4 — パイロットのデザイン

最も代表的なショットを選んでください。最初のショットではありません。通常、動画中盤の統計カードやコンセプトカードです。motion-design を使用して、出荷品質で1フレームを構築します。

motion-design のアンチスロップチェックリストを実行します。3つ以上の失敗はパッチではなく再設計を意味します。

次にユーザーに表示して停止します。 1フレーム、1つの質問:これがルックです — 他のNショットをこれで構築する前に変更することはありますか?

G4 — 明示的な承認がない場合、または NOTES.md に訂正が記録されていない場合に失敗します。

ステージ5 — パイロットのアニメーション

承認されたフレームで motion-animate を呼び出します。レンダリングします。単独ではなく、実際のオーディオに対して視聴します。

G5 — 4つの法則のいずれかに違反した場合に失敗します:どこかでの線形イージング、同時エントランス、約2秒以上完全に静止したカメラ、またはメトロノームのような持続時間。

ステージ6 — 残りのショットのバッチ処理

今、そして今だけ、並列化します。

ショットごと(または類似したショット3~4のグループごと)に1つのサブエージェントにファンアウトします。各エージェントは以下のみを受信します:

  • 自身の plan.json 行。
  • 04-design/tokens.css — 読み取り専用。
  • 模倣するパターンとして、承認されたパイロットシーンへのパス。
  • このショットのエンジン(下の表を参照)。
  • アンチスロップおよびモーションチェックリスト。

各エージェントはレンダリングされたファイルを 06-renders/ に返し、NOTES.md に1行のメモを返します。エージェントは互いに通信せず、トークンを変更しません。

ワークスペースを分離します。 並列エージェントが1つのプロジェクトディレクトリを編集すると互いに上書きします — それぞれにgitワークツリー、コピー、または最低でも重複しないサブフォルダを与え、最後に調整してください。

G6 — 4つのレンダリングをランダムにサンプリングして並べて表示します。同じパレット、同じタイプ、同じ影の方向、同じ粒子、同じコーナー半径ですか? ずれがある場合、ずれたエージェントは自身の出力ではなく、パイロットに対して再構築します。

エンジンの選択

ショットが...次のツールで構築
データ、チャート、マップ、カウンター、長いプログラムシーケンスRemotion
UIモック、ターミナル、キネティックタイプ、クイックHTML+GSAP、調整可能なインスペクタが必要HyperFrames
数学、幾何学、グラフ理論、アルゴリズムのウォークスルーManim
フッテージの上に配置する必要があるもの — トラッキング、プレート統合、ロト、リアルカメラ3DAfter Effects (ae-extendscript を参照)
3Dオブジェクトまたは環境Blender / Unreal、レンダーパス、その後コンポジット
フォトリアルなBロール、プロダクトビューティー、不可能なフッテージAI画像からAI動画へ、その後 tokens.css に再グレード
キャプションadd-subtitles またはキャプションブロック、トークンからスタイル設定
マスタータイムライン、オーディオ、書き出しPremiere / DaVinci

エンジンの混合は正常であり、良いことです — それは最も強力なアンチテンプレートシグナルの1つです。決して混ざってはいけないのはパレットです。

ステージ7 — 統合と出荷

マスタータイムラインにアセンブルします。次に、付録Aを完全に実行します。これは、ショットごとのチェックでは見えないものをカバーします:グラフィック下のオーディオダッキング、キャプションとローワーサードの衝突、セーフエリア、作品全体のペーシング、およびレンダリングスペック。

G7 — すべてのボックスにチェックが入っているか、そうでないものとその理由のリストが書かれています。

ループのクローズ

終了する前に、NOTES.md を読み、次のように尋ねてください:これらの訂正のうち、ユーザーは次の動画でも再度行うものはどれですか?

それらをプロジェクトスキル — .claude/skills/<client>-style/SKILL.md — に変換し、パレット、フォント、ペーシングの好み、禁止された動き、そして伝えなければならなかった訂正を保持します。次の動画はステージ0ではなく、ステージ4から始まります。

これが複利のステップです。訂正されたことを書き留めないエージェントは、永遠に訂正され続けます。

ユーザーがアニメーションを1つだけ欲しい場合

その単一のショットに対してステージ3~5にスキップしますが、それでも:実際の何かからパレットをサンプリングし、両方のチェックリストを実行し、tokens.css を書き込みます。ゲートは安価です。再構築はそうではありません。


付録A · 出荷チェックリスト(G7)

個々のショットではなく、アセンブルされたマスターで実行します。ショットごとのチェックは既に通過しています。これは、すべてが一緒になったときにのみ現れる問題をキャッチします。

全体を2回視聴します:1回はミュートで、1回はグラフィックを非表示にしてフルボリュームで。問題は2つのミックスに隠れています。

1. ショット間の一貫性

  • すべてのショットが tokens.css から色を取得しています。シーンフォルダを、トークンファイルにない生の16進数値でgrepしてください — ヒットはすべてずれです。
  • 影の方向がすべてのショットで同一です。
  • 粒子/テクスチャパスがすべてのショットに同じ強度で存在します。
  • コーナー半径、ストロークの太さ、グロー強度が一致しています。
  • タイプ:全体で同じ2つのファミリー、同じトラッキングルール、同じ大文字小文字ルール。
  • 繰り返し要素(チャプターカード、カウンター、ローワーサード、購読バグ)は、インスタンスごとに再作成されるのではなく、文字通り同じコンポーネントです。
  • ロゴが一貫したスケールとクリアスペースで表示されます。

2. 作品全体のペーシング

  • 隣接する2つのショットがアーキタイプを共有していません。
  • ショットの長さが変化しています。チャート化してください — 平坦な線はメトロノームであり、自動化されたように見えます。
  • RESTビートが生き残っています。すべての行がビジュアルで終わっている場合、計画がどこかでオーバーライドされています。削減してください。
  • 最初の5秒が最も高い密度を持ちます。中盤は息継ぎをします。
  • グラフィックがその行を超えて存続していません。イラストレーションのポイントを過ぎてもぶら下がっているビジュアルはデッドエアです。
  • 画面上の何も速度で読めないものはありません。再生レートですべてのスーパーを声に出して読み上げてください。終えられない場合、長すぎるか速すぎます。

3. フッテージとの統合

  • グラフィックはプレートにグレーディングされており、貼り付けられているわけではありません — 黒レベル、暖かさ、粒子が一致しています。
  • シーン内に配置されることを意図したものには、コンタクトシャドウまたはオクルージョンがあります。
  • 何も話者の顔を覆っておらず、話者の手が動く場所にも配置されていません。
  • ローワーサードとキャプションが決して衝突しません。Zオーダーを一度決定します:グラフィックをキャプションの上に、またはキャプションをグラフィックの上に — そしてそれを維持します。
  • フレーミングがトリミング後も有効です:9:16書き出しでは、被写体とスーパーをキャンバス内だけでなく、可視領域内に維持します。
  • セーフエリアが尊重されています — 外側5%に重要なものはなく、ショートのプラットフォームUIの背後(下部約15%、右約10%)にもありません。

4. オーディオ

  • 音楽が会話の下でダッキングしています。生成されたキーフレームであり、静的なレベルではありません。
  • SFXが必要な瞬間 — エントランス、インパクト、UIクリック、トランジション — にのみ存在し、それ以外にはありません。壁一面のウィッシュはそれ自体がスロップのシグネチャです。
  • SFXは音声の上ではなく、グラフィックの下にミックスされています。ウィッシュに気づく場合、大きすぎます。
  • すべての効果音が、モーションが着地するフレームに(その近くではなく)着地しています。
  • 会話レベルがショット間で一貫しています。カットで部屋のトーンがジャンプしていません。
  • クリーンに終了します:音楽が解決するかフェードアウトし、持続音でのハードカットはありません。

5. 編集自体

  • カットが単語で始まり、息継ぎでは始まりません。
  • 繰り返しのテイク、再開、フィラーが削除されています。
  • ステッチポイントでフレームが重複していません(生成クリップを最終フレームから次の最初のフレームにチェーンするときの古典的な兆候です — 1フレームトリミングしてください)。
  • トランジションに動機があります。トランジションが利用可能だったために存在するトランジションはカットされます。
  • AI生成のBロールはすべてパレットに再グレーディングされ、表示可能なテキストがある場合は、文字化けがないかチェックされています。画面上の文字化けテキストは、生成動画の最も認識しやすいアーティファクトです — クロップするか、ショットを置き換えてください。

6. レンダリングスペック

  • 出力先に対して正しい解像度、fps、カラースペース。
  • アルファショットは、黒の上にベイクするのではなく、ProRes 4444 / QuickTime with alphaとして書き出されています。
  • プラットフォームに対して適切なビットレート。グラデーションにバンディングがない(ある場合は、少量の粒子を追加)。
  • プラットフォームの目標ラウドネスでのオーディオ。ピークは0 dBFS以下。
  • ファイル名が何であるか、どのバージョンかを示しています。

7. 正直な質問

もう一度視聴し、一文で答えてください:視聴者はこれが自動化されたと見破った理由として何を挙げるでしょうか?

何か名前を挙げられるなら、それを修正してください。本当に何もないなら、出荷してください。

失敗ログ

ここで失敗したものはすべて、症状だけでなく原因とともに NOTES.md に記録されます。「ショット12にフラットな背景があった」は症状です。「ショット12のバッチエージェントが tokens.css をインポートしなかった」が原因であり、それがプロジェクトスキルのルールになります。


付録B · エージェントへのブリーフィング(およびサブエージェントへのブリーフィング)

...

[翻訳のため一部省略]

Individual skills in this repo

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

blixvip/skills

The motion vocabulary that separates premium animation from AI slop — text pop-blur-fade, sequential staggers, always-moving eased cameras, object entrances, and the timing/easing tables behind them. Includes ready code for Remotion (interpolate/spring) and HyperFrames (GSAP). Use when animating designed frames, when motion "feels stiff", "bouncy", "jittery", "too fast", "too uniform", or when writing any timing/easing code for video.

blixvip/skills

Source, generate, and prepare the real assets that keep a motion-graphics edit from looking generated — sampling the palette from the footage, collecting style references, pulling 3D models/Lottie/SVG/textures/SFX, generating AI stills and b-roll, and the mandatory conform pass that grades every asset into one palette. Use when a scene needs an icon, logo, 3D object, texture, background, screenshot, chart source, sound effect, or generated image/video, and whenever output "looks flat", "looks stocky", "looks AI", or assets came from different places and no longer match.

blixvip/skills

Design the actual frames for motion graphics and generated UI — palette derived from the footage, type pairing, one of five scene archetypes, and the layering order that produces depth instead of flat AI slop. Use when building scenes in Remotion, HyperFrames, After Effects, or any generated-image pipeline (Nano Banana / GPT Image / Seedream), and whenever output "looks AI-generated", "looks flat", "looks like a template", or needs to match a creator's branding.

blixvip/skills

Turn a script or timestamped transcript into a shot-by-shot motion plan — which lines earn an on-screen visual, which stay bare A-roll rest, what each visual must show, and how long it holds. Use BEFORE designing or animating anything in Remotion, HyperFrames, or After Effects. Triggers on "plan this edit", "what should be on screen", "storyboard this script", "beat map", "where do the animations go", or any request to animate a video that arrives without a shot list.

関連スキル