mcpField
M
motion-authoring

motion-authoring

github.com/insane0777デザイン・UI4137 回インストール4 日前に更新
リポジトリ

motion-authoring について

motion-authoring は、変換済みのウェブサイトプロジェクトに計測済みの動きを追加する開発者向けスキルです。動きの証拠をコードに反映し、計測データと手書きの変更を区別しながら、ビルドとレスポンシブ表示を検証します。

主な機能

  1. 01ページ単位かセクション単位かを選択
  2. 02生成された動きのマニフェストを証拠として利用
  3. 03ページとセクションのアニメーションを作成
  4. 04GSAP ランタイムの重複を回避
  5. 05デスクトップとモバイルでビルドを検証

活用シーン

  1. 01変換済みのサイト再現に動きを追加
  2. 02計測値に基づくページ単位のスクロール演出を実装
  3. 03手書きアニメーションの動きを減らす設定を確認

MCP 対応

Awwwards MCP ツールでページ構造とスクロール挙動を調べ、動きの実装に使うマニフェストを生成します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/insane0777/awwwards-skills --skill motion-authoring

インストール後、Claude Code で/motion-authoringを入力して読み込まれたか確認します。

同梱ファイルLICENSEv2-routing.md

詳細

モーションの作成 — 計測済みマニフェストから実際のモーションへ

ユーザーが変換済みプロジェクトを選択し、かつモーションを作成した場合にのみ実行します。 ジェネレーターが構造、不活性なスケルトンのマウントポイント、 motion.manifest.json(計測済みのトリガー、pageTriggers、初期非表示の ヒント)を生成します。作成の段階で、これらのマウントポイントを実際のモーションにし、 参照との一致をビルドで検証します。これは N2 dogfood のレシピです (nesil:31.21 秒のマスタースクラブ 1 回、正確に 25,650 px の一致)。

プロファイルに関する注意: このスキルのツールは analyze_page_structure、 analyze_scroll_map、build_motion_manifest、および保持されている build_project です。 以下の例では 1.x の名前(デフォルトは full)を使用します。 AWWWARDS_MCP_PROFILE=v2 の場合は、 inspect_page {request:{kind:"structure", url}}、 analyze_motion {request:{kind:"scroll", url, compact:false}}、 build_motion {request:{kind:"manifest", bands, scrollCensus}} を使用してください。 build_project はフラットなままです。census は compact:false にする必要があります。 compact な census には anims[] がなく、build_motion に渡せません。全体の対応表: v2-routing.md。

0. census だけでなく、参照を読む

census から分かるのは、何が、おおよそいつ動くかです。セレクターは 構造上のパスであり、ユーザーの ID やクラスではありません。利用可能な場合は サイト独自のモーションスクリプトを読み、census は裏付けとして扱ってください。 実際のトリガー数、ピン留め、スクラブ比率、継続時間、イージングの種類、 スタッガーの遅延、CSS キーフレーム、GSAP、ネイティブのスクロールタイムラインの どれがアニメーションを制御しているかを確認します。 anims[] は網羅性の確認に使い、タイムラインの導出には決して使わないでください。

1. コードを書く前にトポロジーを決める

確認するのは 1 つです。マスタータイムライン 1 つか、独立したセクショントリガーか?

  • マスタースクラブ 1 つ(高さのあるスペーサー、固定ステージ、スクラブするトリガー 1 つ)→ ラベル付きタイムライン 1 つを持つページレベルの journey モジュールを作成し、 セクションモジュールはそこに追加する薄いスライスビルダーにします。 独立した ScrollTrigger を 7 つに分割してはいけません。重なりや引き継ぎが変わります。
  • 独立したセクショントリガー → マニフェストの triggers[] をキーとして、 セクションモジュールごとにタイムラインを 1 つ作成します。スケルトンにはすでに gsap.context、計測済み定数、更新のための構造が用意されています。

start: null の行は CSS キーフレームまたは所有者のない行です。これは出どころを示すもので、 各行にタイムラインを作成する指示ではありません。

2. マニフェストの契約

motion.manifest.json は根拠資料であり、作成用ファイルではありません。

  • 生成された状態のまま使用し、手動で行を追加したり、measured を切り替えたりしないでください
  • 件数をそのまま記録します(sections、sectionTriggers、pageTriggers)
  • 作成したコードは別途記録します(ファイル名と変更前/変更後)。納品するマニフェストのハッシュは 新たに生成したものと一致させてください。行を追加する必要がある場合は作成した行として示し、 その旨を記載してください。measured: true には決してしないでください
  • pageTriggers はページレベルのモジュールに属し、セクションには属しません
  • まだビルドしていませんか? build_motion_manifest({ bands, scrollCensus, sections? }) は analyze_page_structure と analyze_scroll_map から、このマニフェストの形をそのまま作成します (任意で {label, selector?} によるオーバーライドも可能です)。その エンベロープは measured: false で、DOM の初期状態のヒントは空です(マークアップがないため)。 そのため、census のトリガーに基づいて作成し、以下の方法で作成したコードを記録してください。 手作業でスキャフォールドを measured: true に切り替えてはいけません。

3. インテントマップ(移植するもの、スキップするもの)

インテント移植するものスキップするもの
ローダーの導入サイトのタイムラインに沿ったヒーローシーケンス(名前、カーソルの移動、ふた、キッカー、役割、顔)アナリティクス、スピナー
マスタージャーニー1つのスクラブ可能なタイムライン、セクションの set 時刻、--bg のトゥイーン、ラベル付きセクション無関係なスクリプト
Canvas/ダストステージに合わせたキャンバスサイズ、DPRの上限、数の制限、速度による押し出し、クリーンアップ未使用のパーティクル/WebGLライブラリ
カーソルアイドル状態のトゥイーン、イントロでの引き継ぎ、終了時の引き渡しOSのカーソル置き換え
オーディオループ要素、音量のランプ、切り替え、visibilitychange 時の一時停止自動再生のアサーション
ルーラー/進捗ラベルごとに1つのコントロール、ヘッド位置=進捗カスタムスクロールバー
コピー/フォームクリップボード+フォールバック、ステータスのリセットページに存在しないサーバーサイドの動作
モーションの軽減ヘッドの起動+CSSクラス。作成したコードはGSAPより前にリターンします誰も求めていない「ライト」版

4. 対象環境(GSAPを二重に読み込まないでください)

対象サーフェスルール
NextMotionRoot の前にある SiteScripts 経由のベンダーグローバル、作成したフック/モジュール作成したコードで import gsap を使わないこと。window.gsap/ScrollTrigger の待機時間に上限を設けること
Vite保持したクラシックタグから dist/src/scripts にコピーした window.gsap/ScrollTrigger/Lenisimport gsap を使わないこと
Astro同じグローバル、is:inline のベンダータグ。ページスクリプトを先に、その後にセクションimport gsap を使わないこと

生成されたスケルトンはnpmの gsap をインポートします。これを保持したグローバルに置き換えることで、二重に読み込まれるのを防げます。未使用の gsap 依存関係が残っていても問題ありません。インポートしないでください。

5. 作成の順序

まずページレベル(ローダー → ジャーニー → カーソル → オーディオ → ルーラー)を作成し、次に独立したトリガーを持つセクションを作成します。セクションのループと同じロック手順を維持してください。セクションを作成し、そのセクションのゲート(キャプチャしたジオメトリ+スクリーンショット+明示的なチェック)を再実行してロックし、次に進みます。verify_build はページ全体の集約的な証拠であり、セクションごとのスコアではありません。

6. 検証ゲート(すべて合格すること)

  • すべての対象環境でビルドできること(vite build、astro build、next build +起動プローブ)。
  • デスクトップの1440×900で、バンドアンカー(8か所)において、スクロール高さが±1%以内、表示されるセクションIDが一致し、フォントが一致し、コンソール/ページのエラーと404が0件であること。
  • モバイルの390×844でスモークテストを実施し、横方向のオーバーフローがなく、同じアンカー/表示セクションで、エラーが0件であること。
  • モーションの軽減:ヘッドクラスが適用され、固定ステージが無効になり、オーバーフローがなく、ページが読み取れること。
  • 作成したコードの証明:ソースとビルドツリーに削除対象のサイトスクリプトへの参照が0件であること。保持したベンダーライブラリのみが使われていること。SiteScripts が MotionRoot より前にあること。

失敗のパターン

症状原因修正
作成後にページが反応しないライブラリより先に作成したコードが実行されたグローバルを待つ/SiteScripts を先頭に置く
GSAPランタイムが2つある/イージングがおかしいnpmインポート+ベンダーグローバル保持したグローバルのみを使う
引き継ぎが変わったマスタースクラブをセクションごとのトリガーに分割したページレベルのジャーニーを1つにし、セクションでその一部を切り出す
マニフェストは「計測済み」なのに誤っている手動行をその場で編集した再生成するか、作成した行であることを明示する
モーションは問題ないが、モバイルでページが壊れるデスクトップだけで作成した毎回390のスモークテストを実施する

コメント