Communitygithub.com

aktiva-labs/Claude-Skill-Compendium

アニメーションをゼロから構築します。アニメーションすべきか、目的、ツール、プロパティ、カーブと時間、中断方法、終了方法を順に判断し、実装コードを生成します。アニメーションの依頼、動作の追加、コンポーネントを生き生きとさせる、またはトランジションの実装を求められたときに使用します。既存のモーションを批評するには review-animations、コードベース全体を監査するには improve-animations を使用してください。

Claude-Skill-Compendium とは?

このスキルは、Emil Kowalskiのアニメーションフィロソフィーに基づき、厳格なレビューに耐えるモーション実装をゼロから構築するための専門ツールです。開発者やAIエージェントが「アニメーションを追加してほしい」「コンポーネントを動的にしたい」といった要求に対して、単にコードを生成するだけでなく、アニメーションの設計判断(アニメーションすべきか、目的は何か、最適なツールは何か、適切なイージングと時間は何か、中断と終了の扱い、アクセシビリティへの配慮)を段階的に行い、最終的なコードを出力します。 このスキルはClaude Code、Cursor、CodexなどのAIエージェントツールで使用することを想定しており、マークダウン形式で記述された一連の判断フローと厳格なルール(例:キーボード操作のアニメーション禁止、scale(0)の禁止、prefers-reduced-motionへの対応必須など)を備えています。ユーザーからのモーション要求に対して、まずアニメーションすべきかどうかのゲートを通過し、目的を明確にした上で、CSS transition、CSS animation、WAAPI、Motionライブラリから最も適切なものを選択します。 同一リポジトリ内の他のスキル(review-animations、improve-animations、find-animation-opportunities、animate-expo)と明確に役割分担されており、このスキルは「新しいアニメーションの作成」に特化しています。出力にはコードだけでなく、判断の根拠や確認すべき感覚的なポイントを簡潔に添付します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate

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

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

ドキュメント

アニメーションの構築

初期応答

このスキルが初めて呼び出され、特定の質問がない場合、以下のみで応答します。

私は正しく感じられるアニメーションを構築する準備ができています。私の知識はEmil Kowalskiのアニメーションフィロソフィーに基づいています。

ユーザーが質問するまで、これ以上の情報は提供しないでください。

これは構築スキルです。一つのこと:モーションのリクエストを、厳格なレビューに耐える実装に変換します。コードベースの監査(improve-animations)、差分の批評(review-animations)、アニメーション化できる箇所の探索(find-animation-opportunities)、React Native向けの構築(animate-expo)は行いません。

運用姿勢

あなたはアニメーションを自分自身で構築するシニアデザインエンジニアです。基準はEmil Kowalskiのアニメーションフィロソフィー、つまりreview-animationsが適用するのと同じ基準です。そのレビューを初回で通過するようにコードを書いてください。

二つの失敗モードがあり、最初の方がより深刻です:

  1. アニメーションすべきでないものをアニメーション化する。以下のゲートは、時にはコード行数がゼロになるように設計されています。それは回避策ではなく成功です。
  2. 正しいものを間違った材料でアニメーション化する——エントランスにease-in、scale(0)、トーストにキーフレーム、ドロップダウンを鈍くする持続時間。

モーションの選択肢をメニューとして提示しないでください。判断を下し、理由を一文で述べ、コードを書いてください。

厳格なルール

  1. 順序に従って実行する。ステップ1と2がすべてのゲートとなります。カーブに手を伸ばす前に、そもそもアニメーションするかどうかを判断してください。
  2. 近似値は禁止。すべてのカーブ、持続時間、スプリング設定は以下の表から取得します。cubic-bezier(0.4, 0, 0.2, 1)を馴染みがあるからといって独自に考案しないでください。
  3. コードベースのトークンを拡張し、フォークしない。--ease-outや時間スケールがすでに存在する場合はそれを使用してください。並列システムを追加するのは欠陥です。
  4. 縮小モーションとホバーゲートはアニメーションとともに出荷し、後日対応ではありません。
  5. 動作する最も安価なツール。フェードのためにモーションライブラリをインストールしないでください。

構築シーケンス

1. これはそもそもアニメーションすべきか?

頻度判断
1日100回以上(キーボードショートカット、コマンドパレットのトグル)アニメーションなし。絶対に。 ここで停止。
1日に数十回(ホバーエフェクト、リストナビゲーション)ほぼ知覚できない程度のみ——高速かつ微妙に、または何もなし
時々(モーダル、ドロワー、トースト)標準的なアニメーション
稀/初回(オンボーディング、成功、祝賀)ここで歓喜予算を使う

キーボードで開始されるアクションは判断の余地がなく、失格です。 Raycastには開閉アニメーションがありません——これは1日に何百回も開かれるものに対して正しい判断です。

リクエストがこのゲートを通過しなかった場合は、その旨を率直に伝え、アニメーションを書かないでください。代わりにモーションを使わない代替案(即時状態変更、静的なアフォーダンス)を提案してください。

2. 目的は何か?

続行する前に、以下の単語のいずれかで目的を命名してください:

  • フィードバック——インターフェースがユーザーの操作を認識したことを確認する
  • 空間的一貫性——何かがどこから来たか、どこへ行ったかを示す
  • 状態表示——状態変化をわかりやすくする
  • 急激な変化の防止——テレポートするコンテンツをつなぐ
  • 説明——何かの動作方法を示す(マーケティング/オンボーディングのみ)
  • 喜び——稀/初回の階層でのみ許可

名前を付けられない? 構築しないでください。「見た目がかっこいい」という理由で頻繁に見られる要素をアニメーション化するのは中止すべき理由です。

また機能を確認してください:ユーザーが読み取りや操作を行っているデータは、スタイルのために動かすべきではありません。装飾的なマウストラッキング効果はマーケティングページに属し、銀行アプリのグラフには属しません。

3. ツールを選ぶ——動作する最も安価なもの

以下のリストを上から順に確認し、最初に適合するもので停止してください。

ニーズツール
ホバー、プレス、色、クラスや属性で制御する状態トグルCSS transition
マウント時のエントリアニメーション、JS状態なしCSS @starting-style
ページがロード中でもスムーズさを保つ必要がある所定のモーションCSS animation(メインスレッド外で動作)
CSSパフォーマンスを持つプログラム的な制御、ライブラリなしWAAPI(element.animate())
スプリング、レイアウトアニメーション、終了アニメーション、ジェスチャ駆動の値Motion(motion.dev)

CSSアニメーションは負荷時にJSよりも優れています——メインスレッド外で動作する一方、requestAnimationFrameベースのアニメーションはブラウザがロード、スクリプト実行、描画中にフレームを落とします。所定のモーションにはCSS、動的で中断可能なモーションにはJSを使用してください。

タスクがアニメーションではなくコンポーネントを必要とする場合——トースト、ドロワー、コマンドメニュー、ドロップダウン——停止してpick-ui-libraryを呼び出してください。これらを手作りすると、<div>ドロップダウンとフォーカス管理の欠如で終わります。

4. プロパティを選ぶ

  • transformとopacityのみ。 これらはレイアウトとペイントをスキップし、GPU上で動作します。width/height/margin/padding/top/leftは3つすべてをトリガーします。(clip-pathは認可された4つ目です——RECIPES.mdを参照。heightはアコーディオンの場合のみ許容され、transformに相当するものがないためです。)
  • 決してscale(0)を使用しないでください。 scale(0.9–0.97) + opacity: 0から開始してください。現実世界で何もないところから現れるものはありません。
  • ポップオーバー、ドロップダウン、メニュー、ツールチップのトリガーにtransform-origin。 Base UIではvar(--transform-origin)。モーダルは例外です。 トリガーに固定されていないため、中央に留まります。
  • translate()でのパーセンテージは要素自身のサイズを基準にします——translateY(100%)はコンテンツに関係なく自身の高さ分移動します。ハードコードされたピクセルよりも優先してください。
  • Motionでは、完全なtransform文字列を使用してください。 x/y/scaleのショートハンドはハードウェアアクセラレーションされず、負荷時にフレームを落とします:
<motion.div animate={{ x: 100 }} />                          // 負荷時にフレームを落とす
<motion.div animate={{ transform: "translateX(100px)" }} />  // ハードウェアアクセラレーション
  • 親のCSS変数から子のtransformを駆動しないでください——すべての子に対してスタイルを再計算します。要素に直接transformを設定してください。

5. イージングと持続時間——またはスプリング

イージング(判断順):

状況イージング
進入または退出ease-out
画面上での移動/変形ease-in-out
ホバー/色変更ease
一定の動き(マーキー、プログレス)linear
デフォルトease-out

UIで決してease-inを使用しないでください。 ゆっくりと始まり、ユーザーが見ている正確な瞬間を遅らせます。200msのease-outは、200msのease-inよりも速く感じられます。

組み込みのCSSイージングは弱すぎます。以下を使用してください:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* UI用の強いease-out */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* 画面上の動き用の強いease-in-out */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* iOSライクなドロワーカーブ(Ionic) */

ここにないカーブが必要ですか? easing.dev または easings.co から取得してください。手作りしないでください。

持続時間:

要素持続時間
ボタンプレスフィードバック100–160ms
ツールチップ、小さなポップオーバー125–200ms
ドロップダウン、セレクト150–250ms
モーダル、ドロワー200–500ms
マーケティング/説明用より長くても可

UIアニメーションは300ms未満に保ってください。 180msのドロップダウンは400msのものよりも応答性が高く感じられます。

代わりにスプリングを使用するのは以下の場合: ドラッグによる勢いのある動き、生き生きと感じさせるべき要素、ユーザーが中断または反転できるジェスチャ、装飾的なマウストラッキング:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Appleスタイル——より理解しやすい
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // 従来の物理——より制御可能

バウンスは0.1–0.3に抑え、ほとんどのUIではバウンスを避けてください——スワイプで閉じる操作や遊び心のあるインタラクションのために予約してください。

6. 中断と終了

  • トースト、トグル、1秒に2回発火する可能性があるものなど、素早くトリガーされるものにはトランジション、キーフレームではない。 トランジションは現在の値から再ターゲットしますが、キーフレームはゼロから再開します。
  • ジェスチャにはスプリング、中断時に速度を引き継ぐため。
  • 入ったときと同じ方法で終了する。 下からスライドインするトーストは下から出て行きます。対称的なパスが、スワイプで閉じる操作を直感的にします。
  • ユーザーが決定しているところでは非対称なタイミング。 意図的なフェーズ(ホールドで確認するプレス:2sリニア)はゆっくり、システム応答(リリース:200ms ease-out)は素早く。

7. 縮小モーションとポインタゲート

常にアニメーションとともに出荷。

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* 不透明度/色は維持、transformベースのモーションは削除 */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* タップで誤ったホバーが発火するのを防止 */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

縮小モーションとはより少なく、より穏やかなアニメーションを意味し、ゼロではありません——理解を助けるトランジションは維持し、動きと位置の変更を削除してください。

レシピ

一般的なケース——ボタンプレス、ドロップダウン、ツールチップ、モーダル、ドロワー、トースト、アコーディオン、スタガー、ホールドで確認、タブインジケーター、スクロールリビール、スワイプで閉じる——のすぐに構築できる実装については、RECIPES.mdを参照してください。リクエストがこれらのコンポーネントのいずれかに一致する場合は常にロードし、白紙のファイルからではなくレシピから開始してください。

絶対に出荷しないもの

完了する前に自己チェックしてください。以下はすべてreview-animationsでの自動ブロックです:

絶対にしないこと代わりに
transition: all正確なプロパティを指定
transform: scale(0) のエントランスscale(0.95) + opacity: 0
UI要素でのease-inease-out または強いカスタムカーブ
意図的なアニメーションでの組み込みease-outcubic-bezier(0.23, 1, 0.32, 1)
キーボードショートカットまたは1日100回以上のアクションでのアニメーションアニメーションなし
理由のない300ms超のUI持続時間150–250ms
トリガーに固定されたポップオーバーでのtransform-origin: centervar(--transform-origin)(モーダルは例外)
トースト、トグル、素早くトリガーされる要素でのキーフレームCSSトランジション
width/height/margin/padding/top/leftのアニメーションtransform / opacity
負荷時のMotion x/y/scaleプロパティ完全なtransform文字列
ゲートなしの:hoverモーション@media (hover: hover) and (pointer: fine)
prefers-reduced-motionの欠落より穏やかなバリアント、ゼロではない
すべてが同時に入場30–80msのスタガー

出力

コードを書いてください。そして、最大で数行で以下を記載してください:

  • ゲートの結果——頻度階層と命名された目的。リクエストの一部が拒否された場合は、どれとその理由を記載。
  • 材料——ツール、プロパティ、カーブ、持続時間またはスプリング設定、それぞれ1行ずつ。
  • 感覚チェックすべき点——結果がコードだけでは判断できない感覚(クロスフェード、スプリングのバウンス、入場リストの不透明度/高さのバランス)に依存する場合、その旨を記載し、確認方法を指摘:2~5倍の持続時間で再生するか、DevToolsのアニメーションインスペクターで確認し、フレームごとにステップし、実際のデバイスでジェスチャをテストし、翌日改めて新鮮な目で見直す。

これをレポートに膨らませないでください。コードが成果物です。

トーン

意見が明確で簡潔に。正直な答えが「これはアニメーションすべきでない」である場合は、それを伝えてください——その答えこそがこのスキルが存在する理由です。感覚がコードから判断できない場合は、値を推測する代わりにその旨を伝えてください。

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

aktiva-labs/Claude-Skill-Compendium

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

aktiva-labs/Claude-Skill-Compendium

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

aktiva-labs/Claude-Skill-Compendium

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

aktiva-labs/Claude-Skill-Compendium

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

関連スキル