Communitygithub.com

MengTo/Skills

プロファイル、監査、最適化を行うフロントエンドページパフォーマンス。アニメーション処理、メモリリークのリスク、長時間セッションのスローダウン、CSSアニメーション、canvas/WebGL requestAnimationFrame ループ、マーキー、スケルトン、GSAP/Three/Matter エフェクト、タイマー、リスナー、オブザーバーを重点的に扱います。

Skills とは?

このスキルは、フロントエンドページのアニメーション関連パフォーマンスをプロファイル、監査、最適化するための包括的なワークフローを提供します。主な焦点は、オフスクリーンアニメーションの停止、メモリリークの特定と修正、スクロールジャンクの解消、CPU/GPU使用率の低減です。具体的には、CSSアニメーション、canvas/WebGLループ(requestAnimationFrame)、GSAP/Three/MatterなどのJavaScriptアニメーションライブラリ、マーキー、スケルトンローダー、および各種タイマーやイベントリスナーを対象とします。このスキルは、Codex Browserを利用したライブプロファイリングとソースコード監査を組み合わせ、IntersectionObserverを用いた可視性ベースのアニメーションポーズや、React/Vite/Next.jsなどのモダンフレームワークにおける適切なクリーンアップ(リスナー解除、RAFキャンセル、Three.jsリソース解放)を実装します。React/Next.js/Viteアプリケーションで、アニメーションのちらつき、長時間使用によるパフォーマンス低下、メモリリークの問題を診断・修正する場合に特に有用です。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/codex/optimize-web-animations

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

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

ドキュメント

Webアニメーションの最適化

基本ルール

実際のページを編集前に測定すること。目的は動作を削除することではなく、オフスクリーンでの動作を停止させ、表示されている状態では正しく再開させ、ルート/アンマウント時にクリーンアップが行われて長期リソースが解放されるようにすることです。

可能な場合はCodex Browserを使用してください。特にlocalhostページでは推奨します。ユーザーが明示的に要求した場合を除き、Chromeは使用しないでください。

ワークフロー

  1. リポジトリのコンテキストを調査する。

    • AGENTS.md またはローカルの指示を読む。
    • 早期に git status --short を実行する。
    • ページコンポーネント、アニメーションフック、CSSキーフレーム、requestAnimationFrame、setInterval、setTimeout、canvas/WebGL/physicsコンポーネント、メディア要素、GSAPタイムライン/トゥイーン、既存の可視性ユーティリティを特定する。
    • エフェクトのクリーンアップで、イベントリスナー、オブザーバー、RAFループ、インターバル、タイマー、外部スクリプト、メディアストリーム、WebGLテクスチャ/マテリアル/ジオメトリ/レンダラー、およびアンマウント後に完了する可能性のある非同期処理を検索する。
    • ワークツリーがダーティな場合、最初から狭いステージングを計画する。
  2. ブラウザでベースラインを取得する。

    • ユーザーが指定した正確なルートを開く。
    • ページ上部、中間、フッター/下部コンテンツ、およびレイアウトが異なる可能性がある1つのモバイルビューポートでプロファイルを取得する。
    • 計算された animationName、animationPlayState、および可視性によりCSSアニメーションをカウントする。::before と ::after を含める。
    • canvas/WebGL要素は個別に検査する。CSSプロファイリングだけではRAFループが停止したことを証明できない。
    • オフスクリーンで実行されているアニメーション名と、その原因となっているDOM所有者を記録する。
    • メモリ/リークの要求の場合、要素/キャンバス/画像/iframeのカウント、利用可能な場合の露出したJSヒープメトリクス、10〜30秒後のアイドルサンプル、および短いルートサイクルサンプルも記録する。ヒープAPIが null を返すか、Browserサンドボックスがモンキーパッチをブロックする場合は、その旨を明記し、安定した観測可能なカウントとソース監査に依存する。
    • ストレステストは制限された範囲に留める。プロファイリング中のブラウザタブのクラッシュは過負荷の証拠であるが、最小限のテストで再現されない限り、原因を過大に帰属しない。
    • 再利用可能なCodex Browser評価ツールについては references/browser-profiling.md を参照。
  3. 動作を制御する最小の所有者にパッチを適用する。

    • アプリに既存のページリビール/可視性フックがある場合は、それを優先する。
    • それ以外の場合は、セクションとアニメーションする子要素に is-offscreen のような安定したクラスをトグルする IntersectionObserver を追加する。
    • CSSアニメーションを対象としたルールで一時停止する:
main > section.is-offscreen .expensive-animation,
.expensive-animation.is-offscreen {
  animation-play-state: paused !important;
}
  • 繰り返しカードやプレースホルダーの場合、ドキュメント全体ではなく、カードシェルとアニメーションする子孫を監視する。
  • マーキー/ティッカートラックの場合、そのセクションがオフスクリーンのときにトラックを一時停止する。
  • スケルトンローダーや疑似要素グリマーの場合、必要に応じて ::before と ::after の一時停止セレクターを含める。
  • canvas/WebGL/physicsループの場合、RAFループを直接ゲートする:
    • キャンバス/コンテナが交差したときに開始する。
    • オフスクリーン時に requestAnimationFrame をキャンセルする。
    • 再入場時に再開する。
    • クリーンアップ時にオブザーバーを切断し、フレームをキャンセルする。
    • ブラウザ検証に役立つ場合、data-animation-active のような非視覚的デバッグマーカーを追加する。
  • コンポーネントがすでに prefers-reduced-motion を尊重している場合はそれに従い、スクロール/アニメーション状態のためのReactレンダーループの導入を避ける。
  • リーク対策:
    • エフェクトによって作成されたすべてのタイムアウト/インターバルをクリアする。
    • アンマウント前およびループ再開前にRAFをキャンセルする。
    • IntersectionObserver、ResizeObserver、MutationObserver、およびカスタムサブスクリプションを切断する。
    • 同じハンドラ参照を持つグローバル/ウィンドウ/ドキュメントのリスナーを削除する。
    • Three/WebGLのテクスチャ、マテリアル、ジオメトリ、レンダラーを破棄し、レンダラーDOMノードを削除する。
    • DOMノードおよびシェーダーユニフォームなどの可変オブジェクトに対するGSAPトゥイーン/タイムラインを強制終了する。
    • メディアストリームを停止し、切り離されたビデオ/オーディオソースを一時停止する。
    • 非同期ローダーを isDisposed フラグで保護し、アンマウント後に解決した場合にロードされたリソースを破棄する。
    • Reactのクリーンアップでは、lintがrefが変更される可能性があると警告する場合、returnする前にエフェクト内で ref.current の値をキャプチャする。
    • 可視性ポーズ後の物理またはシミュレーションフレームデルタを制限し、遅延フレームが過大な更新を実行しないようにする。
  1. ビルドだけでなく、動作を検証する。

    • ルートをリロードし、同じ上部/中間/フッター/モバイルプロファイルを再実行する。
    • 目標結果:テスト中のページセクションで offscreenRunningCount: 0。
    • 表示されているアニメーションが引き続き実行されるか、スクロールして表示されたときに再開されることを確認する。
    • RAF/キャンバスループがオフスクリーンで非アクティブ、ビュー内でアクティブであること、またはソース/ランタイム状態からキャンセルが証明されていることを確認する。
    • リーク監査の場合、前後のルートサイクルとアイドルサンプルを比較する。DOM/キャンバス/画像のカウントは、繰り返しナビゲーション後に同じベースラインに戻る必要があります。わずかな非同期コンテンツ変更は許容されます。
    • 検索/フィルター/ナビゲーションなどの通常のページインタラクションを実行し、オブザーバーが動的コンテンツを壊さないことを確認する。
    • 新しいタブのコンソール警告/エラーを確認する。
  2. ローカルチェックを実行する。

    • リポジトリの通常のゲートを使用する。React/Viteアプリの場合、多くの場合これで十分です:
git diff --check
npm run lint
npm run build
  • 既知の致命的でない警告は、失敗とは別に言及する。
  1. リポジトリまたはユーザーの指示に従って、狭い範囲でコミットする。
    • 無関係なダーティ変更が存在する場合、分離されたインデックスを使用する:
rm -f /tmp/<task>-index
GIT_INDEX_FILE=/tmp/<task>-index git read-tree HEAD
# 意図したハンクのみを一時インデックスに適用する。
GIT_INDEX_FILE=/tmp/<task>-index git diff --cached --check
GIT_INDEX_FILE=/tmp/<task>-index git commit -m "オフスクリーン <page> アニメーションを一時停止"
git restore --staged <files> 2>/dev/null || true
  • ダーティワークツリーから広範なファイルをステージングしてはならない。すべてのハンクがタスクに属する場合を除く。
  1. 証拠をもって報告する。
    • 発見事項を先頭に:まだ実行されていたもの、リークの可能性があるもの、測定できなかったもの。
    • ソース監査のリスクとライブブラウザ測定を分離する。
    • サンプリングされた正確なルート、オフスクリーンアニメーションカウント、DOM/キャンバスカウントの安定性、ルートサイクル結果、およびローカルチェックを含める。
    • 特に利用できないヒープカウンターやブロックされたブラウザ計測については、制限を明確に述べる。

良い修正パターン

  • 長いセクションで、ビューポート外の子アニメーションがまだ実行される可能性がある場合、セクションレベルの is-offscreen と要素レベルの is-offscreen を併用する。
  • ルートごとに共有される可視性セレクター定数。例:COURSES_PAGE_ANIMATION_VISIBILITY_SELECTOR。
  • アニメーションゲーティング用の IntersectionObserver しきい値 0.01 程度。
  • WebGL/キャンバスエフェクト用の直接RAFループ制御。CSS animation-play-state ではJavaScriptレンダーループを一時停止できない。
  • 一時停止または遅延フレーム後に再開する物理ループ用のフレームデルタ制限。
  • GSAP/WebGLエフェクトで使用されるReact ref用のキャプチャされたクリーンアップノード。
  • アンマウント後に解決する可能性がある画像/ビデオ/テクスチャ/データローダー用の isDisposed ガード。
  • 蓄積するDOMノード、キャンバス、iframe、または未解放メディアをキャッチするための短いアイドルおよびルートサイクルプローブ。

避けるべきこと

  • プロファイルを通過させるためにすべてのアニメーションを削除すること。
  • 祖先セレクターが広すぎるために、表示されているヒーロー動作を一時停止すること。
  • animation-play-state が疑似要素やJavaScript RAFループをカバーすると想定すること。
  • 長いページで単一のページ上部測定を信頼すること。
  • 利用できないヒープカウンターをメモリリークがない証拠として扱うこと。
  • ブラウザで無制限のストレスループを実行すること。制限されたサイクルを使用し、クラッシュを記録するが、因果関係を過大に述べないこと。
  • パフォーマンスの証拠としてスクリーンショットのみを使用すること。
  • コミットに無関係なローカルハンクを混在させること。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

MengTo/Skills

Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography, zoom-follow framing, ffprobe/thumbnail verification, and optional native recording compatibility checks. Use when the user asks to record or re-record browser actions, show cursor clicks and zooms, make Dribbble/UI inspiration or product demo recordings, or asks whether Codex, Playwright, or an MCP can produce a natural browser demo video.

MengTo/Skills

Generate ElevenLabs text-to-speech audio from scripts or inline text using local voice profiles. Use when the user asks for ElevenLabs, text-to-speech, TTS, narration, voiceover, speech audio, or voice generation; load voice names, voice ids, emails, owners, and account-specific defaults only from local config outside the skill.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Create cinematic scroll-driven landing pages with Lenis smooth scrolling, GSAP ScrollTrigger, scroll-linked progression, staggered text reveals, sticky card stacks, parallax backgrounds, scroll-scrubbed transitions, footer reveals, and immersive preloaders. Use when analyzing or building premium editorial scroll experiences, sticky project stacks, kinetic typography, or section-by-section storytelling.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

関連スキル