使い方ガイドへスキップ
fixing-motion-performance作者 Julien Thibeaut

Fixing Motion Performance スキル。

Claude Code と Codex のモーションおよび動画向けスキル:カクついた CSS/JS アニメーションやスクロール連動モーションを検出・修正します。

  • モーションと動画
  • レビューレポート
ibelick/ui-skills · skills/fixing-motion-performance/SKILL.mdSKILL.md
--- name: fixing-motion-performance description: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance. --- ## how to use ## when to apply ## rendering steps glossary ## rule categories by priority ## common fixes ## review guidance
2026-09-14 に上流ファイルから読み取ったフロントマターとセクション見出し · 全 5,561 文字

01 できること

Claude Code と Codex における fixing-motion-performance スキルの機能

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

CSS および JS のアニメーションパフォーマンスを対象とした監査・修正のプレイブックで、ぎこちないトランジション、スクロール連動モーション、ブラー効果をレビューまたはリファクタリングするデザイナーや開発者向けです。スラッシュコマンドとして提供され、単体で呼び出すと会話中のアニメーション作業全般にガイドラインを適用し、ファイルを渡すと該当行を引用しながら違反を報告し、その重要性とコードレベルの修正案を示します。

ルールは優先度順に並んでおり、never パターン、メカニズムとツールの境界(クリティカル)から始まり、計測、スクロール、ペイント、レイヤー、ブラーを経て、ビュートランジションへと続きます。求められない限りアニメーションライブラリの移行は行わず、既存スタック内でルールを適用します。

生成されるもの

  • 違反ごとに、その重要性を説明する短い一文。
  • 各違反に対する、コードレベルの具体的な修正。
  • デフォルトと異なるレンダリング処理の選択について明記された根拠。
プロンプト例を見る ↗

仕組み

  1. 01
    スラッシュコマンドとして呼び出す

    /fixing-motion-performance を実行すると、セッション内で既に議論されているアニメーション作業に制約が適用されます。

  2. 02
    またはファイルを指定する

    パスを渡すとレビューモードに切り替わり、進行中の作業に制約を課す代わりに、そのファイルをすべてのルールに照らして検証します。

  3. 03
    3部構成でレポートする

    各所見では該当行を引用し、その重要性を短い一文で説明した上で、コードレベルの修正案を提示します。

  4. 04
    レンダリングステップ別にプロパティを整理する

    グロッサリーは作業をコンポジット、ペイント、レイアウトに分類し、どのアニメーションが低コストでどれが高コストかをレビュアーが把握できるようにしています。

  5. 05
    優先順位に従って適用する

    影響度の低いカテゴリーより先にクリティカルなカテゴリーが検証されるため、never パターンとツールの境界が最初に確定します。

  6. 06
    現在のスタック内に留める

    ライブラリの移行は作業の対象ではありません。ルールは、コードベースが既に使用しているアニメーションシステムに対して適用されます。

02 適合性を確認

fixing-motion-performance スキルを使用するタイミング

Claude Code または Codex で fixing-motion-performance スキルを使用するのは、この種のモーションとビデオの作業の場合です。適合性と制限事項は、スキル自身のファイルから取得されています。

適している場合

  • CSS、WAAPI、Motion、rAF、GSAP で書かれたUIアニメーションを追加または変更する場合。
  • すでにぎこちなく感じるインタラクションやトランジションをリファクタリングする場合。
  • 現在scrollイベントで動いているスクロール連動モーションやreveal-on-scroll効果を実装する場合。
  • レイアウト、フィルター、マスク、グラデーション、CSS変数をアニメーションさせる場合、コストのプロファイルこそが本質的な問題です。
  • will-change、transform、計測に依存しているコンポーネントをレビューする場合。

境界を知る

  • ナビゲーションレベルの変更を超えるビュートランジション、たとえばインタラクションの多いUIや中断可能である必要があるフローの場合。
  • 継続的または大面積のブラー効果。これは最適化の対象ではなく除外されます。

提供すべきもの

  • スラッシュコマンド単体ライブでの作業では、そのまま呼び出すだけで十分です。それにより、会話中に行われるアニメーションの変更全体が形作られます。
  • レビューモード用のファイルパス1つのファイルを渡すと、スキルはそのファイルをすべてのルールと照合してレビューし、違反レポートを作成します。
  • 既存のアニメーションシステム対象となるライブラリを指定する必要はありません。現状のコードが基準となり、その中でルールが適用されます。

03 スキルの内部

fixing-motion-performance スキルが Claude Code と Codex に与えるルール

SKILL.md がエージェントに設定する 8 つの具体的な指示・既定値・制限 — 結果を変える部分です。

  1. 読み取りと書き込みを絶対にインターリーブしない

    同一フレーム内でレイアウトの読み取りと書き込みを混在させてはならず、それぞれがレイアウトを計測または変更する複数のアニメーションシステムを同時に実行してはなりません。

  2. スクロール位置からアニメーションを絶対に駆動しない

    scrollTop、scrollY、scrollイベントからアニメーションを駆動することは禁止されています。代わりにScrollまたはView TimelinesとIntersectionObserverを使用してください。

  3. すべてのrAFループには終了条件が必要

    停止条件のないrequestAnimationFrameループは、許容されるトレードオフではなく、絶対に避けるべきパターンです。

  4. デフォルトはtransformとopacity

    これらはコンポジタープロパティであり、モーションの出発点です。JS駆動のアニメーションは、それを必要とするインタラクションのために予約されています。

  5. ブラーは8px以下に制限

    ブラーアニメーションは8px以下の小さい範囲に留め、短い一度限りの効果に限定する必要があります。継続的なブラーや大面積へのブラーは対象外です。

  6. will-changeは局所的に使用する

    レイヤーのプロモーションは自動では行われないため、will-changeは一時的かつ狭い範囲で適用され、多数または大きなプロモーション済みレイヤーに残したままにはしません。

  7. モーション用にCSS変数をアニメーションさせない

    transform、opacity、positionを駆動するカスタムプロパティはアニメーションさせてはならず、継承されたアニメーション変数は一切禁止です。

  8. 中途半端な移行は行わない

    1つのコンポーネント内でAPIを部分的に移行してはならず、アニメーションスタイルを混在させてもいけません。

04 実際に使う

Claude Code または Codex に fixing-motion-performance をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、または使用中のエージェントに fixing-motion-performance を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/ibelick/ui-skills --skill fixing-motion-performance

skills/fixing-motion-performance/SKILL.md用の汎用skills CLI形式です。リポジトリによっては独自のパスが記載されている場合があります。

スキルに最初のモーション・動画タスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Use /fixing-motion-performance on [path/to/Component.tsx]. The [side panel] transitions width on hover, the reveal-on-scroll is wired to a window scroll listener, and there is a blurred overlay on a full-width section. Report each violation with the exact line, why it matters, and a concrete fix, working within our existing [Motion] setup rather than migrating libraries.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • 提案された修正が、意図した効果に見合う最も低コストなレンダリング処理になっているかを確認します。
  • 画面外に移動したものが実際に一時停止または停止しており、動作し続けたままになっていないかを確認します。
  • レイヤーの昇格が重要な箇所では、想定に頼るのではなくツールで検証します。

OpenDesignではfixing-motion-performanceをそのSKILL.mdリンクからインポートします:Plugins → Add → Skill → Import from link、その後トップバーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Repository
github.com/ibelick/ui-skills ブランチ main
スキルファイル
skills/fixing-motion-performance/SKILL.md 検証時にコンテンツチェックサムを記録。コミット 79081ab
License
MIT LICENSE より
リポジトリスター数
8,402 ibelick/ui-skills リポジトリ全体の GitHub スナップショット(2026年9月14日取得)。このカタログには5つのスキルが含まれています。fixing-motion-performance の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. 使い方単体で呼び出すとセッションが制約され、ファイル引数を指定すると違反の完全なレポートがトリガーされます。
  2. 適用タイミングアニメーション作業中にこれらのガイドラインを適用すべき5つの状況を列挙しています。
  3. レンダリングステップ用語集composite、paint、layoutを定義し、それぞれが対象とするプロパティを示します。
  4. 優先度別ルールカテゴリ9つのカテゴリを、critical(重大)からlow(低)までの影響度ラベルでランク付けします。
  5. クイックリファレンス禁止パターンからツールの境界まで、短い箇条書き制約を9つの番号付きカテゴリにまとめています。
  6. よくある修正レイアウトスラッシング、スクロール連動モーション、FLIP計測に関するCSSとJSのビフォーアフターのスニペットです。
  7. レビューの進め方レビューの進め方:まず重大な問題から、最も低コストな処理を優先し、デフォルト以外の選択には根拠を示し、実行可能な指摘を行います。
スキル自身による説明
「レイアウトスラッシング、コンポジタープロパティ、スクロール連動モーション、ぼかし効果を含むアニメーションパフォーマンスの問題を監査して修正します。アニメーションがカクつく、トランジションがジャンクする、または CSS/JS アニメーションパフォーマンスをレビューする際に使用してください。」

SKILL.md からのフロントマターの説明です。完全なファイルは約5,561文字です。GitHub で完全なファイルを読む。

06 インストールする前に

fixing-motion-performanceスキルに関する質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

どのアニメーションライブラリに対応していますか?

対象範囲としてCSS、WAAPI、Motion、rAF、GSAPを挙げているため、特定のフレームワークに限定されない広範な内容です。既存のシステム内でルールを適用する仕組みなので、これらのうちどれを使用していても対応できます。

Fixing Motion Performance

実際のモーションと動画タスクで fixing-motion-performance を実行します。

OpenDesign をダウンロードし、SKILL.md リンクから fixing-motion-performance をインポートして、上記のプロンプトを貼り付け、結果の前に計画を確認してください。

ターミナル
npx skills add https://github.com/ibelick/ui-skills --skill fixing-motion-performance

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応