Communitygithub.com

BEKO2210/Firstbrain

レイアウトスラッシング、コンポジタプロパティ、スクロール連動モーション、ブラー効果など、アニメーションのパフォーマンス問題を監査・修正します。アニメーションがカクつく、トランジションがギクシャクする、CSS/JSのアニメーションパフォーマンスをレビューする場合に使用します。

Firstbrain とは?

このスキルは、UIアニメーションのパフォーマンス問題を診断・修正するための包括的なガイドラインを提供します。レイアウトスラッシング、連続的なレイアウトアニメーション、スクロール連動モーション、過剰なブラー効果など、一般的なパフォーマンスの落とし穴を特定し、改善します。CSS、WAAPI、Motion、rAF、GSAPなど、あらゆるアニメーションスタックに対応しており、コンポジタプロパティ(transform、opacity)を優先し、ペイントやレイアウトを伴うアニメーションを最小限に抑えるルールを厳格に適用します。測定処理のバッチ処理、FLIP方式の採用、レイヤー生成の適切な管理など、具体的かつ実践的な修正方法を提示します。特にクリティカルなルール(禁止パターン、ツール境界)から優先的に適用し、既存のアニメーションライブラリのマイグレーションは明示的に要求されない限り行わないというポリシーを守ります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/fixing-motion-performance

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

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

ドキュメント

motion-performanceの修正(fixing-motion-performance)

アニメーションパフォーマンスの問題を修正します。

使用方法

  • /fixing-motion-performance この会話内のすべてのUIアニメーション作業に以下の制約を適用します。

  • /fixing-motion-performance <ファイル> ファイルを以下のすべてのルールに照らしてレビューし、以下を報告します:

    • 違反(該当する行またはスニペットを引用)
    • なぜ重要なのか(簡潔な一文)
    • 具体的な修正(コードレベルの提案)

明示的に要求されない限り、アニメーションライブラリを移行しないでください。既存のスタック内でルールを適用します。

使用すべきタイミング

以下の場合にこれらのガイドラインを参照してください:

  • UIアニメーション(CSS、WAAPI、Motion、rAF、GSAP)を追加または変更する場合
  • ギクシャクしたインタラクションやトランジションをリファクタリングする場合
  • スクロール連動モーションやスクロールによる表示を実装する場合
  • レイアウト、フィルター、マスク、グラデーション、CSS変数をアニメーションさせる場合
  • will-change、transform、measurementを使用するコンポーネントをレビューする場合

レンダリングステップの用語集

  • コンポジット:transform、opacity
  • ペイント:色、境界線、グラデーション、マスク、画像、フィルター
  • レイアウト:サイズ、位置、フロー、グリッド、フレックス

優先順位別ルールカテゴリ

優先順位カテゴリ影響
1禁止パターンクリティカル
2メカニズムの選択クリティカル
3測定高
4スクロール高
5ペイント中-高
6レイヤー中
7ブラーとフィルター中
8ビュートランジション低
9ツール境界クリティカル

クイックリファレンス

1. 禁止パターン(クリティカル)

  • 同じフレーム内でレイアウトの読み取りと書き込みを交互に行わない
  • 大規模または重要なサーフェス上でレイアウトを連続的にアニメーションさせない
  • scrollTop、scrollY、またはスクロールイベントからアニメーションを駆動しない
  • 停止条件のないrequestAnimationFrameループを使用しない
  • それぞれがレイアウトを測定または変更する複数のアニメーションシステムを混在させない

2. メカニズムの選択(クリティカル)

  • モーションにはデフォルトでtransformとopacityを使用する
  • インタラクションで必要な場合にのみJS駆動のアニメーションを使用する
  • ペイントまたはレイアウトのアニメーションは、小さく孤立したサーフェスにのみ許容される
  • ワンショットエフェクトは連続モーションよりも許容されることが多い
  • モーションを完全に削除するよりも、手法をダウングレードすることを優先する

3. 測定(高)

  • 一度測定し、その後はtransformまたはopacityでアニメーションさせる
  • すべてのDOM読み取りを書き込みの前にバッチ処理する
  • アニメーション中にレイアウトを繰り返し読み取らない
  • レイアウト的なエフェクトにはFLIPスタイルのトランジションを優先する
  • 測定と書き込みをバッチ処理するアプローチを優先する

4. スクロール(高)

  • スクロール連動モーションには、利用可能な場合はScrollまたはView Timelinesを優先する
  • 可視性と一時停止にはIntersectionObserverを使用する
  • アニメーションのためにスクロール位置をポーリングしない
  • 画面外ではアニメーションを一時停止または停止する
  • スクロール連動モーションは、大規模なサーフェスで連続的なレイアウトやペイントをトリガーしてはならない

5. ペイント(中-高)

  • ペイントをトリガーするアニメーションは、小さく孤立した要素にのみ許可される
  • 大きなコンテナ上でペイント負荷の高いプロパティをアニメーションさせない
  • transform、opacity、または位置のためにCSS変数をアニメーションさせない
  • 継承されたCSS変数をアニメーションさせない
  • アニメーションさせるCSS変数はローカルにスコープし、継承を避ける

6. レイヤー(中)

  • コンポジタモーションにはレイヤープロモーションが必要であり、決して自動的に行われると想定しない
  • will-changeは一時的かつ限定的に使用する
  • 多くのプロモートされたレイヤーや大きなレイヤーを避ける
  • パフォーマンスが重要な場合はツールを使用してレイヤーの動作を検証する

7. ブラーとフィルター(中)

  • ブラーアニメーションは小さく(<=8px)保つ
  • ブラーは短く、一度きりのエフェクトにのみ使用する
  • ブラーを連続的にアニメーションさせない
  • 大きなサーフェスでブラーをアニメーションさせない
  • ブラーよりもopacityとtranslateを優先する

8. ビュートランジション(低)

  • ビュートランジションはナビゲーションレベルの変更にのみ使用する
  • インタラクションの多いUIにはビュートランジションを避ける
  • 中断またはキャンセルが必要な場合はビュートランジションを避ける
  • サイズ変更はレイアウトをトリガーする可能性があると考える

9. ツール境界(クリティカル)

  • 明示的に要求されない限り、アニメーションライブラリを移行または書き換えない
  • 既存のアニメーションシステム内でこれらのルールを適用する
  • 同じコンポーネント内でAPIを部分的に移行したり、スタイルを混在させたりしない

一般的な修正例

/* レイアウトスラッシング:widthの代わりにtransformをアニメーション */
/* 修正前 */ .panel { transition: width 0.3s; }
/* 修正後 */ .panel { transition: transform 0.3s; }

/* スクロール連動:JSの代わりにscroll-timelineを使用 */
/* 修正前 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 修正後 */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// 測定:読み取りを書き込みの前にバッチ処理(FLIP)
// 修正前 — レイアウトスラッシュ
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 修正後 — 一度測定し、transformでアニメーション
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });

レビューガイダンス

  • まずクリティカルなルール(禁止パターン、ツール境界)を適用する
  • 意図に最も適合する、最も負荷の低いレンダリング作業を選択する
  • デフォルト以外の選択をする場合は、それを正当化する制約(サーフェスサイズ、期間、インタラクション要件)を明記する
  • レビュー時は、理論よりも実用的な指摘と具体的な代替案を優先する

接続

  • ドメイン: [[Design & Kreativitaet]]
  • カテゴリ: [[3D & Animation]]
  • ナビゲーション: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

関連スキル