Communitygithub.com

AlperTuncOrtak/crypto-data-pipeline

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

crypto-data-pipeline とは?

このスキルは、CSS、JavaScript(WAAPI、Motion、rAF、GSAP)を使ったUIアニメーションのパフォーマンス問題を自動的に検出・修正するためのツールです。レイアウトスラッシング、過剰なペイント、スクロール連動アニメーション、ぼかし効果の多用など、よくあるパフォーマンス低下の原因を特定し、具体的なコードレベルの修正提案を提供します。 主な用途は、(1)アニメーションがカクつく・ぎこちない場合の診断、(2)CSS/JSアニメーションコードの事前レビュー、(3)パフォーマンス改善のためのリファクタリングです。このスキルは、Claude Code, Cursor, CodexなどのAIエージェントと連携して動作します。SKILL.mdに記載された9つのルールカテゴリ(クリティカル、高、中、低の優先度順)に基づいて違反をチェックし、現状のアニメーションライブラリを別のものに移行することはなく、既存のスタック内でルールを適用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/skills/fixing-motion-performance

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

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

ドキュメント

モーションパフォーマンスの修正

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

使用方法

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

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

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

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

使用すべきタイミング

以下のガイドラインを参照するタイミング:

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

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

  • コンポジット: transform、opacity
  • ペイント: color、borders、gradients、masks、images、filters
  • レイアウト: size、position、flow、grid、flex

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

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

クイックリファレンス

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

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

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

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

3. 測定(高)

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

4. スクロール(高)

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

5. ペイント(中-高)

  • ペイントをトリガーするアニメーションは、小さく独立した要素でのみ許可される
  • 大きなコンテナ上でペイント負荷の高いプロパティをアニメーションさせない
  • transform、opacity、またはpositionのために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';
// 修正後 — 1度測定し、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 = ''; });

レビューガイダンス

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

制限事項

  • タスクが上記の範囲に明確に一致する場合にのみこのスキルを使用する
  • 出力を、環境固有の検証、テスト、専門家レビューの代わりとして扱わない
  • 必要な入力、権限、安全境界、成功基準が不足している場合は、停止して明確化を求める

Individual skills in this repo

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

AlperTuncOrtak/crypto-data-pipeline

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

関連スキル