Claude Eye: フレームごとのアニメーション分析
あなたは動画を見ることはできませんが、画像を読むことはできます。このスキルは動画をタイムスタンプ付きのフレームセットに変換し、各フレームを調べてアニメーションしているすべての要素の状態を記録し、それらの観察結果をタイムラインにまとめて、いつ同期がずれるかを正確に示します。CSS/JSアニメーションのタイミングバグは通常100~300msのずれであり、目で見るには速すぎますが、フレームテーブルで確認するのは簡単です。
スクリプトはこのファイルと同じディレクトリの scripts/ にあります。Node 18+ と ffmpeg/ffprobe のみが必要で、npm install は不要です。以下、<skill> はこのスキルのディレクトリを示します。
1. 前提条件の確認
ffmpeg -version を実行します。インストールされていない場合は、ユーザーに知らせ、OSに応じたインストールコマンドを提示します(Windows: winget install Gyan.FFmpeg または choco install ffmpeg;macOS: brew install ffmpeg;Linux: sudo apt install ffmpeg)。インストール後は新しいターミナルが必要です。許可なく自分でインストールしないでください。
2. フレームの抽出
node <skill>/scripts/extract_frames.mjs <video> --fps 5 --out ./claude-eye-output [--start S] [--end S] [--width 960]
これにより、frames/frame_NNNN.png と、各フレーム番号をタイムスタンプにマッピングする manifest.json が作成されます。タイムスタンプは常にマニフェストから取得し、自分で計算しないでください。
画像読み取りの予算を管理してください。 読み取るフレームごとにコンテキストを消費するため、1パスあたり約40フレーム以下を目指してください。
- 短いクリップ(約8秒未満): 全体を5fpsで十分です。
- 長いクリップ、または問題がどこにあるかわからない場合: まず粗いパス(動画全体を
--fps 1または2)で、動きのある箇所を見つけます。その後、そのウィンドウのみを高いfps(--start/--end、--fps 10~15)で別の--outディレクトリに再抽出します。精密なパスの結果を報告します。 - ユーザーが特定の瞬間を指定した場合(「3秒あたり」「タイトルが入るとき」)、そのウィンドウに直接移動します。
デフォルトの960px幅は、不透明度と位置を判断するのに十分です。要素が非常に小さい場合にのみ、大きい --width を使用してください。
3. フレームを確認し、観察結果を記録する
Readツールを使用してフレームを順番に読み取ります。各フレームについて、アニメーションしているか、アニメーションする可能性のあるすべての表示テキスト/UI要素(タイトル、字幕、ボタン、画像、ハイライトスパン、オーバーレイなど)を記録します。
セレクター名はフレーム間で安定させてください: 要素を最初に見たときに説明的なケバブケースの名前(hero-title、subtitle、cta-button)を選び、後続のすべてのフレームでその名前を正確に再利用します。タイムラインは名前でフレームを結合するため、あるフレームで hero-title、次のフレームで title とすると、別々の要素として扱われ、分析が崩れます。要素が出現した、または存在することがわかった時点で、0%の状態でも含めてください。これにより「非表示→遷移中」のポイントが可視化されます。
各要素について、以下を見積もります:
opacity_percent(0-100)。背景と、後のフレームで完全に表示されたときの要素の見え方と比較して判断します。また、部分的な表示もカウントします:クリップパスやマスクワイプで40%表示されている場合は、40とカウントします。state:hidden(≤10%)、transitioning-in(上昇中)、visible(≥90%)、transitioning-out(下降中)のいずれか。隣接するフレームと比較して「in」と「out」を判断します。- オプション:
has_gradient、has_blur、および動きに関するnotes(`