Communitygithub.com

モーション・マッチ

ユーザーが参照動画、GIF、スクリーンレコーディングからアニメーションを測定し、自分のデザインで再現または照合する際に使用します。静止画からスムーズなモーションを指示したり、動画を広告に編集する際にも利用します。

モーション・マッチ とは?

モーション・マッチは、任意のアニメーションを分析・再現・検証するためのAIエージェントスキルです。参照動画(またはGIF)から各カット、各要素の開始・持続時間・イージング・オーバーシュート・移動距離・回転・形状変化を測定し、CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI、After Effectsなどの多様なプラットフォーム向けにモーションを再構築します。±0.08秒以内のフレーム単位比較で一致を確認し、「スムーズ」を主張ではなく検証します。静止画のみの場合でも、UI・リール・説明動画向けのモーションをClaudeが設計し、ディレクターモード・ストーリーモードで対応します。また、ユーザー生成・AI生成・撮影済みの動画クリップを編集し、キャプションやモーショングラフィックスを追加する編集モードも備えています。ffmpeg、Python(numpy、Pillow)、Playwrightを使用し、外部サーバーへのアップロードは一切行いません。

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

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

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

ドキュメント

モーション・マッチ: アニメーションを測定し、再現し、同じ動きであることを証明する

「これをこんな風に動かして」を数値に変換します: すべてのカット、そして動く各要素に対して、開始・持続時間・イージング、オーバーシュート、移動距離、回転、形状変化。ユーザーが使用するツール(CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI、After Effects)でモーションを再構築し、フレームごとに比較して、タイミングが±0.08秒以内で一致するまで繰り返します。参照モーションがなく、静止画のみですか? ディレクターモード(下記)をUIエントランス用に、ストーリーモードをリールや説明動画用に使用します: Claudeがモーションをデザイン・構築し、同じスクリプトで自身のレンダリングを測定するため、「スムーズ」は主張ではなく確認されます。動画クリップを広告に編集する場合(UGC、AI生成、撮影済み)? 編集モードを使用します: 同じ測定、ディレクタールール、レビューをフッテージに適用します。 手法は NiazMorshed2007/reanimate および rossark0/rossark-motion-skill(いずれもMITライセンス)を参考にしています。スクリプトは独自のものです。

<skill> はこのスキルのフォルダです。作業はカレントフォルダの ./motion-match/<name>/ に置きます: ref/(参照分解)、ours/(自レンダリング分解)、compare-N/(各比較ラウンド)、spec.md。

セットアップ(初回)

PATHにffmpeg/ffprobe、およびnumpyとPillowを備えたPython 3が必要です。

  • 確認: python3 -c "import numpy, PIL"。失敗した場合、それらを持つPythonを探します(既存のプロジェクトvenvなど)。見つからなければ、ユーザーに一度だけ尋ねた後、python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow を実行し、以下 python として ~/.motion-match/venv/bin/python を使用します。すべてのスクリプトは -I 付きで実行します。
  • ディレクターモードとストーリーモードでは、ページをヘッドレスでレンダリングします: pip install playwright && python -m playwright install chromium(一度だけ尋ねます)。インストールできない場合は、代わりにページをスクリーンレコーディングし、タイミングの精度が落ちることを伝えます。
  • その他のインストールは不要。どこにもアップロードしません。

0. スコープ(測定前に spec.md の先頭に記述)

  • ターゲット: ユーザーが指定した通りのファイル + 時間範囲(+ クロップ)(「最初の3秒」「ボタンだけ」)。
  • 忠実度: モーション忠実(デフォルト): 順序、タイミング(±0.08秒)、イージングファミリー、オーバーシュート、要素のサイズに対する移動距離、スガー。ユーザー自身のアート、色、フォント、言葉。ピクセル忠実は、ユーザーが明示的に依頼し、かつ個人練習の場合のみ: 他人のデザイン、ロゴ、キャラクター、音楽はそれらのもの。コピーの公開を支援することは決してしません。
  • 出力先: モーションが使用されるツールやコード(不明な場合は一度尋ねます: 出力形式を決定します)。
  • 参照の取得: ユーザーが提供するファイル、またはユーザーが作成するスクリーンレコーディング(ウェブサイトやアプリ: インタラクションを録画。スキルはフレームから動作し、サイトのコードからは取得しません)。YouTubeやサイトからのダウンロードは、ユーザーがその特定の動画を明示的に要求した場合のみ、専用フォルダに保存し、非公開の参照素材として扱います。

1. 分解

python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h] → ソースfpsで全フレーム、sheets/timing_NN.png(全フレーム: タイミング、イージング、フォロースルー)および sheets/poses.png(1秒あたり2枚: 何が起きているか)。すべてのシートを読みます。GIFも同様に動作します。

2. 測定

  • カットとセクション: python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align 参照のカット(シーンチェンジ)と移動とその時間をリストします。静止しない参照は、そのカットで分割されます。
  • 正確な色: python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(コンタクトシートではなく、フルサイズフレームのピクセル座標)。
  • 各動く要素: track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks] (または --not-bg HEX で「背景以外のすべて」)。発光している、または込み入った参照では常に --region とその要素に固有の色を指定し、表示される可視フレーム範囲が妥当かを確認します。フレームごとに位置(cx cy)、サイズ(w h)、スカッシュ(aspect)、エッジ、フェード/成長(presence)、色、回転(angle)を記録します。
  • 各移動: python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B (1ウィンドウに1移動、カットをまたがない)→ 開始、終了、持続時間(ミリ秒とフレーム数)、イージングファミリー、オーバーシュート、セトル時間、およびCSS、WAAPI、Framer Motion、GSAP、Remotion用のコピー可能な行。誤差 ≤ 0.03 は良好な適合。「単一のイージーが適合しない」場合は、ウィンドウを分割するか、ポーズの連鎖(キーフレーム)であることを意味します。
  • 微小な動き(2%のスカッシュ、5pxのフロート)はシートには表示されませんが、トラックの数値には表示されます。それらを読み取ります。
  • 小さくフェードインするテキストはアクティビティ曲線のノイズに近くなります。代わりに track_motion で測定します。

どの数値がどの種類の動きを測定するか

動き測定方法備考
移動、スライド、フロートcx, cy軸ごとに1回の適合
スケール、成長、スカッシュw, h, aspect
フェードpresence(--colors 付き)
回転、スピンangle(度、時計回り+、360度を超えて連続)シルエットから。円の場合は None: 円上のマークを別要素として追跡し、その cx/cy を適合。n倍対称性の形状(正方形: 4倍)は1フレームあたり < 180/n 度が必要なため、高速スピンには高fpsのソースが必要です。領域内の同じ色の他の形状が妨害します: --region を狭く
モーフ(形状→形状)--save-masks、その後 shape_compare.py下記参照
3Dフリップ/カード回転w(cosのように縮小)+ presence; 中点で色が反転裏面は別要素として扱う
パスモーション(弧、曲線)cx と cy の両方、さらにパスに沿って回転する場合は angle各軸を適合; パス形状はシートに表示
クリップ/マスク表示、ワイプx1 または y1(先端)、w/h
ラインの描画presence
テキスト分割(単語/文字ごと)最初と最後の単語を追跡; スガーは開始間隔 ÷ (カウント − 1)
カウンター、チャートバーバー: h/y0; 数字: シート(目視)

モーフ。 track_motion.py ... --name blob --save-masks で各フレームのシルエットを保存(中央揃え、等面積にスケール)。その後:

  • python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B で track_blob.json に morph 系列を追加(0 = 最初の形状、1 = 最後)。fit_easing.py ... --prop morph で開始、終了、持続時間を取得。モーフ進行は面積に基づくため、タイミングは信頼できますが、イージング名は貼り付け可能な値ではありません。仕様から、または追跡可能なパラメータ(w、aspect、angle)からイージーを取得してください。
  • 自レンダリングと参照の比較: shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate] → 形状パス: 参照のすべての中間形状が、時間に関係なく自レンダリングにも存在しているか(合格: 平均 ≤ 10%、最大 ≤ 25% of モーフ全体)。その後 fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK でタイミングを確認。--rotate は、モーフが同時にスピンする場合に回転を無視(angle で確認)。

3. モーション仕様の記述(spec.md; 各行がチェック項目になります)

| # | 要素 | プロパティ | 変化 | 開始秒 | 持続時間秒(フレーム数) | イージング | オーバーシュート | スガー / 備考 | ソース |
| 1 | カード | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | カードあたり+0.08秒 | track + fit_easing |
| 2 | アイコン | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | ブロブ | morph | 四角 → 円 | 0.50 | 0.40 (12) | easeInOutCubic | — | 形状パス PASS | shape_compare |
| c | — | cuts | — | 1.77, 2.33 | — | — | — | — | motion_compare self |

行に「?」がある場合、フレームがまだ読み取られていないことを意味します。動かない要素も記載します。ジョブが大きい場合は、構築前に仕様をユーザーに表示します。

4. 構築

ユーザーのツール、ユーザーのデザインで。仕様からタイミングを、そのツール用のフィッターの出力からイージングをコピーします。レイアウトが異なる場合は、距離を要素またはフレームに対して相対的にマッピングします。ポーズの連鎖: スムーズでオーバーシュートしない補間のキーフレーム。参照がオーバーシュートしてセトルする場合はスプリング。

  • 回転: transform-origin を明示的に設定(ピボットを測定: cx, cy が変わらない点)。
  • モーフ: SVGパスは、両端で同じ数と種類のコマンドが必要(または flubber / GSAP MorphSVG を使用)。UIレイアウトのモーフ(ボタン→カード、サムネイル→ページ)はFLIPまたは共有要素トランジション(Framer layoutId、View Transitions API)を使用。角丸/サイズのモーフはプレーンなCSS。
  • 3D: 親に perspective 800–1200 px、backface-visibility: hidden、両面を別々のレイヤーとして。

5. 比較と修正(2〜5ラウンド)

  1. 同じウィンドウ、同じfpsで自レンダリングをレンダリングまたはスクリーンレコーディング(ウェブページは参照と同じ方法で録画)。
  2. ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json (同じウィンドウ、クロップ、fps、フレームサイズ)。
  3. motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N → オフセット、すべてのカットと移動の開始/終了/持続時間/ピーク誤差、±0.08秒以内でPASS、activity.png(両方の曲線)、sheets/compare_NN.png(参照 | 自レンダリング | 差分)。毎ラウンドシートを読みます。
  4. 仕様の行ごとに: 同じ方法で自レンダリングを追跡し、fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK → 移動ごとのタイミング PASS/FAIL、移動距離とイージングファミリーの一致。モーフ行: さらに shape_compare.py --vs。
  5. エビデンスが示す最も小さな問題を修正し、再レンダリング、繰り返し。5ラウンド後も失敗している項目は、その数値と理由を報告。許容範囲を黙って緩めてはいけません。
症状一般的な原因修正方法
すべてが一定のオフセットでずれている開始遅延またはトリガーレイテンシ最初の遅延を調整
自レンダリングが短く、前半に詰まっているイージングが強すぎる(expo vs cubic)適合されたベジェを使用
参照はオーバーシュートするが、自レンダリングはしないスプリング/back vs プレーンイージーback.out / 測定されたオーバーシュートに調整したスプリング
自レンダリングの動きが早く止まる二次的な動きが欠落している(ドリフト、プッシュイン)そのウィンドウのシートを確認
自レンダリングに余分な動きやカットがある参照で静止しているものがアニメーションしている削除するか遅延させる
要素番号が跳ねるトラッキングが別の要素を捕捉した--region を狭く、それに固有の色を使用
回転移動は正しいが、cx/cy で自レンダリングがぐらつくtransform-origin が間違っているピボットを測定された静止点に移動
モーフタイミング PASS、形状パス FAILパスの補間が異なる(点の順序、開始点)パス点を並べ替える/コマンドを一致させる。モーフライブラリを使用

6. 報告

忠実度; マッチしたものとユーザー自身のもの; 最新の比較テーブル(カットと移動の誤差、PASS/FAIL); 要素ごとの行; activity.png と比較シートへのパス; 残っているすべての差異(数値と理由); およびどのチェックが測定(スクリプトで生成)されたか、目視(シートを見て)されたか。

ディレクターモード: 静止画入力、モーションをデザイン

参照モーションがなく、ユーザーが画像(UIスクリーンショット、モックアップ、ポスター、製品写真)を提供する場合、またはClaudeにモーションを選択させる場合に使用します。作業は通常通り ./motion-match/<name>/ に置きます(ours/、spec.md、check-N/)。ビデオ作品(UIエントランス以外)の場合は、以下の手順をストーリーモード(下記)内で実行します。

  1. 画像を読み取る。 すべての要素(背景、ナビ、見出し、本文、画像、CTA、カード、アイコン)を、px単位のボックス、役割、ランク(1つの焦点、次にサポート、最後に装飾)とともにリスト。リーディングオーダー、グループ(カード行、リスト)、ムード(落ち着いた/プレミアム、ニュートラル/プロダクト、遊び心)、および特別なモーションを示唆するもの(トグルアイコン、チャート、ロゴマーク、曲線パス、反転可能カード)を記録。
  2. パーソナリティを選択(ムードから。ユーザーが指定した場合はそれを使用)。オプションを求められた場合は、3つすべてを構築。
パーソナリティエントランス持続時間イージング移動距離スガーオーバーシュート
落ち着いたフェード + 上昇400–600 mseaseOutQuart / cubic-bezier(.25,1,.5,1)8–16 px60–80 msなし
ニュートラルフェード + 上昇、またはスケール .97→1250–400 mseaseOutCubic / cubic-bezier(.33,1,.68,1)12–24 px40–60 msなし
遊び心上昇 + スケール .9→1スプリングスプリング (stiffness 300–400, damping 20–26)16–32 px50–70 ms3–8%
  1. 役割に応じて特別なモーションを選択(語彙; 値は開始点であり、パーソナリティでスケーリング):
モーション使用場面デフォルト
モーフアイコントグル(メニュー ↔ 閉じる、再生 ↔ 一時停止)、ボタンがカードやシートに拡大する場合、形状ロゴ300–500 ms easeInOutCubic; レイアウトモーフは FLIP/共有要素
回転トグル/シェブロンアイコン、リフレッシュ、傾いたエントランスアイコン 90–180°、200–300 ms easeOutCubic; エントランス −6…−10° → 0、パーソナリティのイージーで; ローダー 360° 線形 0.8–1.2 s ループ
3Dフリップ / 傾き二面カード、価格トグル、ホバー奥行きフリップ rotateY 180°、500–700 ms easeInOutCubic; ホバー傾き ≤ 8°
パスモーション移動するもの(飛行機、ルート上の点、カーソル)easeInOutSine、パスに沿って回転、0.8–1.6 s
クリップ / マスク表示ヒーローイメージ、大きな見出しinset または円クリップ、500–800 ms easeOutQuart
テキスト分割メイン見出しのみ単語 40–60 ms 間隔、文字 15–30 ms; 行全体 ≤ 1 s
ライン描画アイコン、署名、チャート、アンダーラインstroke-dashoffset、600–1000 ms easeInOutCubic
カウンター / チャート成長数字、バー、リング数字 800–1200 ms easeOutExpo; バーはベースラインから、スガー 40–60 ms
パララックス / 奥行きレイヤードヒーロー、スクロールシーンレイヤー速度 0.2–0.6 of スクロール; サポートされていればスクロールタイムライン
  1. コレオグラフ は以下のルールに従う:
    • 順序: 背景/コンテナ → 焦点 → 見出し → サポート → CTA。装飾(ナビ)は最後、またはページをフレームする場合は最初に150msの素早いフェード。
    • サイズが持続時間を決定(アイコンは低め…

(元の内容は切り捨てられていますが、翻訳は与えられた範囲で完了しています。)

関連スキル