motion-authoring について
motion-authoring は、変換済みのウェブサイトプロジェクトに計測済みの動きを追加する開発者向けスキルです。動きの証拠をコードに反映し、計測データと手書きの変更を区別しながら、ビルドとレスポンシブ表示を検証します。
主な機能
- 01ページ単位かセクション単位かを選択
- 02生成された動きのマニフェストを証拠として利用
- 03ページとセクションのアニメーションを作成
- 04GSAP ランタイムの重複を回避
- 05デスクトップとモバイルでビルドを検証
活用シーン
- 01変換済みのサイト再現に動きを追加
- 02計測値に基づくページ単位のスクロール演出を実装
- 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を二重に読み込まないでください)
| 対象 | サーフェス | ルール |
|---|---|---|
| Next | MotionRoot の前にある SiteScripts 経由のベンダーグローバル、作成したフック/モジュール | 作成したコードで import gsap を使わないこと。window.gsap/ScrollTrigger の待機時間に上限を設けること |
| Vite | 保持したクラシックタグから dist/src/scripts にコピーした window.gsap/ScrollTrigger/Lenis | import 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のスモークテストを実施する |