Communitygithub.com

scroll-video-website

ネイティブスクロールで動画をシークし、オブジェクトの遷移をページコンテンツに連動させるウェブサイトを構築または改良します。スクロール駆動のシネマティックなエントランスや写真のようなオブジェクトモーションに使用し、通常の自動再生動画埋め込みではありません。

scroll-video-website とは?

このスキルは、承認されたビデオシーケンスをレスポンシブでリバーシブルなウェブサイトインタラクションに変換する方法を提供します。既存のサイトスタックと承認済みアセットを再利用し、特定のアニメーションライブラリに依存しません。スクロール位置をビデオのタイムラインとオブジェクトのCSSトランスフォームにマッピングすることで、プロダクトターン、インテリアの演出、アートワークなど、視覚的なストーリーを伝える没入型のエントランス体験を実現します。主要機能として、ネイティブスクロールによるビデオシーク(シークの最適化とフレームスキップ防止)、写真のようなオブジェクトの連続性(位置・投影の一致)、ハイブリッドエントランス(タイムドセグメントとスクロール制御の組み合わせ)、アクセシビリティ(フォーカス管理、減少モーション対応)を含みます。このスキルはClaude CodeやCursorなどのAIエージェント向けに設計されており、ワークフローは「インタラクションの確立」「メディアの準備」「スクロールからタイムラインへのマッピング」「オブジェクトの連続性の維持」「ウェブサイトアクセスの維持」「検証と引き渡し」の6つのフェーズで構成されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

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

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

ドキュメント

スクロールビデオウェブサイト

承認されたビジュアルシーケンスを、レスポンシブでリバーシブルなウェブサイトインタラクションに変換します。既存のサイトスタックと承認済みアセットを再利用します。この手法は特定のアニメーションライブラリを必要としません。対象、パス、および最終状態はプロジェクトの入力値です。プロダクトターン、インテリアの演出、アートワーク、その他のビジュアルストーリーにこのワークフローを適用します。落下するレコードとターンテーブルは一例であり、必須のシーンではありません。

インタラクションの確立

編集前に、現在の実装、承認済みバージョン、および最新のユーザーフィードバックを調査します。そのコンテキストから以下を解決します:

  • ビデオ内の動きはどれか、コードで個別にアニメーション化されるオブジェクトはどれか?
  • スクロールがクリップ全体を制御するのか、それとも意図的なタイムドセグメントがスクロールに先行するのか?選択された動作に従います。最初からスクロールさせるリクエストは、クリックゲートなしで最初のホイールまたはタッチスクロールで機能する必要があります。
  • 最終シーンはどこで通常のページコンテンツになるのか?訪問者はどのようにしてメインコンテンツに直接到達できるか?
  • どのサイズとプラットフォームが重要か、どのプレビューが利用可能であるべきか?

タイミングまたは制御の変更のみがリクエストされた場合は、メディアを再生成しないでください。現在の作業バージョンを保存し、比較が必要な場合は隔離された代替バージョンを作成します。

メディアの準備

正確なビデオと対応するデコードされた開始・終了静止画を使用します。カラー解釈、アスペクト比、およびソースファイルを保持します。シーム自体に問題がある場合は、インタラクションエフェクトで隠す前にメディアの受け渡しを修正します。

長さ、フレームレート、寸法、およびシーク動作を検査します。より短いキーフレーム間隔はスクラビングに役立つことがあります。全キーフレームコピーはローカルプロトタイプには便利ですが、デプロイには大きすぎる可能性があります。実際のブラウザで派生版をベンチマークし、配信を別途最適化します。すべてのクリップに対して単一のエンコード設定を規定しないでください。

メタデータとフレームの読み込み中はポスターを保持します。最新のリクエスト時刻を保持し、ビデオの準備ができたときにそれを適用します。ビデオがない場合や拒否された場合は、コンテンツへの使用可能な静的ルートを残す必要があります。

スクロールをタイムラインにマッピング

  1. 既存のレイアウトに適合する場合は、ネイティブスクロールトラックとスティッキーなビジュアルステージを使用します。スクロールがエントランスの制御である場合は、ドキュメントをすぐにスクロール可能に保ちます。スクロールバーをシミュレートするためだけのホイールインターセプションやタッチキャプチャは避けます。
  2. 選択したストーリーを、被写体の動き、カメラの演出、落ち着いたシーン、オブジェクトの移動、コンテンツなどの意図的な範囲に分割します。プロジェクトに役立つフェーズのみを使用します。プロダクトターンに落下や部屋の演出を含める必要はありません。簡潔だが重要なイベントには十分な距離を割り当てます。各範囲をメディアまたはトランスフォームの進行にマッピングします。クリップの秒数はスクロールピクセルに均一にマッピングされる必要はありません。
  3. スクロールイベントによってスケジュールされた1つのrequestAnimationFrameから更新します。測定時のみレイアウトを読み取り、すべてのアニメーション更新内で繰り返し行わないでください。
  4. スクラビングのためにビデオを一時停止したままにします。シークを統合します。最新のターゲットを保存し、保留中のシークがある間は競合するシークを開始せず、seeked後に最新のターゲットを適用します。古いフレームのバックログを構築しないでください。
  5. エンドポイントをクランプし、端数のビューポート計算には小さなピクセル許容誤差を使用します。実際のブラウザのスクロール位置を使用して最初と最後のフレームをテストします。
  6. 停止したスクロールは現在の状態を保持します。選択されたインタラクションに従って各フェーズを逆転します。クリップ全体がスクロール制御されている場合の開始アクションも含みます。
  7. 訪問者がホイール、タッチ、またはナビゲーションキーの入力を提供した場合は、プログラムによる移動をキャンセルします。リサイズや復元されたスクロール位置が、開始状態を予期せずスキップするのを防ぎます。

ハイブリッドエントランスの場合、どのセグメントがタイムドで、逆スクロールがどこで停止するかを明示的に定義します。完全にスクロール制御されたエクスペリエンスに、タイムドセグメントを静かに導入しないでください。

写真のようなオブジェクトを連続させる

選択した動きと受け渡しの間、実用的な場合(プロダクトが詳細ビューに移動する場合やアートワークがギャラリーに移る場合など)、1つの可視オブジェクトを使用します。デスティネーションに再ペアレンティングする場合は、その変更の前後で位置と投影を一致させます。

完全なエンドオーバーエンドフリップには、エッジを露出させる3D回転が必要です。平面内回転は異なる動きです。テクスチャ付き平面は、プリントやレコードなどのフラットなオブジェクトに適しています。これを完全にモデリングされた3Dシーンとして記述しないでください。回転中にシルエットが変化するソリッドなプロダクトには、適切な撮影/生成ビューまたは3Dアセットが必要です。

ソースとデスティネーションの測定値を一貫した座標系で維持します。ステージがスティッキーな場合は、ビューポート座標とドキュメント座標を混在させないでください。リサイズ時に再測定し、意味のある進行を保持します。依存アクションを物理的な原因で順序付けます。たとえば、デスティネーションがターンテーブルの場合、レコードが着地するまで針を上げたままにし、再生状態が始まる前に針を下げます。

一致する照明とシーンジオメトリを使用してシーン境界をブレンドします。見出しとコンテンツリンクは、視覚的に忙しい画像の上に配置するのではなく、読みやすい状態に保ちます。狭いビューポートでは、オブジェクトの横に十分なスペースがない場合は、コンテンツをオブジェクトの下に配置します。

ウェブサイトアクセスを維持する

ストーリーの選択された時点でナビゲーションを表示します。長いフィルムが終了した後だけでなく、直接カテゴリアクセス、スキップ、リプレイ、およびシーンへのルートを維持します。カテゴリ変更がオブジェクトを交換することを意図している場合は、選択されたコンテンツおよび依存する動きと連携させます。迅速な選択は最新のリクエストで確定する必要があります。

ターゲットまたはその祖先がinert(無効)状態である間は、ターゲットにフォーカスを設定しないでください。最初にインタラクティブにしてから、追加のスクロールジャンプなしでフォーカスします。プロジェクトダイアログが閉じた後にフォーカスを復元します。

減少モーションパスでは、スクラビングやフリップなしで、後方へのスクロール時も含め、使用可能な静的シーンを表示する必要があります。失敗したメディアの状態は永続的にし、後方へのスクロールで壊れたオーバーレイを復元できないようにします。

検証と引き渡し

サポートされているブラウザツールを使用して、内部アニメーション関数の呼び出しだけでなく、実際の入力をテストします:

  • 新しいロード状態から、クリックせずにスクロールします。途中で停止し、続けてから開始位置まで逆スクロールします。
  • ビデオ/静止画の受け渡しとオブジェクトからデスティネーションへの結合を視覚的に検査します。
  • アニメーションオブジェクトの遷移がデザインの一部である場合、アニメーションオブジェクトが正しい位置にある状態でメインコンテンツに到達します。カテゴリ変更、スキップ、リプレイ、キーボードフォーカスを実行します。
  • デスクトップと電話のレイアウト、途中でのリサイズ、減少モーション、および意図的に利用不可にしたビデオを確認します。
  • 水平方向のオーバーフロー、メディアの読み込み、コンソールエラーを確認します。ブラウザエミュレーションと実際の電話テストを区別します。

レビューURL、有用なスクリーンショット、保存されたベースライン、および重要なパフォーマンスまたはデバイステストの制限事項を提供します。ソースメディアとタイミングを識別する簡潔なマニフェストを保持します。ローカルレビューの実装は、それ自体では公開を許可しません。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル