Communitygithub.com

aktiva-labs/Claude-Skill-Compendium

実際のデバイスでフィーリングが正しいReact NativeおよびExpoアニメーションを構築します。アニメーションの対象、実行スレッド、プロパティ、スプリング/タイミング、ジェスチャーの連携、劣化の仕方など、重要な判断を順序立てて行います。Reanimated、Gesture Handler、Expo Router、expo-hapticsを使用して実装します。Expoアプリで何かをアニメーションさせるとき、ジェスチャー、シート、画面遷移、プレスフィードバック、ハプティクスを追加するとき、またはデバイス上でカクつくモーションを修正するときに使用します。Webアニメーションには`animate`を使用してください。

Claude-Skill-Compendium とは?

このスキルは、React NativeとExpoで本番品質のモバイルアニメーションを構築するための包括的なガイドです。核心となる哲学は、実際のデバイス上での動きの「フィーリング」を重視し、シミュレーターやフラッグシップスマートフォンでの開発モードではなく、低速な実機でのリリースビルドで検証することを要求します。 スキルは、モバイルアニメーションに固有の3つの原則に基づいています:ホバーがない、ReanimatedワークレットとReactランタイムの2つのランタイムが存在する、ユーザーの指が直接要素に触れるという点です。これらを前提に、まずアニメーションの必要性を厳密に判断し(高頻度の操作はアニメーションしない)、目的を明確化し、最適なツールを選択する順序で進めます。 実装では、Reanimated 4のワークレットを活用してUIスレッド上でアニメーションを実行し、JavaScriptスレッドへの負荷を最小限に抑えます。スプリングとタイミングの使い分け、プロパティ選択(transform/opacity優先)、ハプティクスの適切な使用、アクセシビリティ対応(ReduceMotion)まで、実践的な知見を網羅しています。 対応プラットフォームはiOSとAndroidで、Expo SDKバージョンと自動的に整合する`npx expo install`での依存関係管理を推奨しています。このスキルは、Emil Kowalskiのアニメーション哲学に基づき、カクつきのない滑らかで自然なモバイルUIアニメーションを実現するために設計されています。

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

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

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

ドキュメント

Expoでのアニメーション構築

初期応答

このスキルが最初に特定の質問なしで呼び出された場合、以下のみを返答してください:

ExpoとReact Nativeで実際のデバイス上で正しいフィーリングのアニメーションを構築する準備ができています。私の知識はEmil Kowalskiのアニメーション哲学に基づいています。

ユーザーが質問するまで、他の情報は一切提供しないでください。

React Native向けの建設スキルです。モーションのリクエストを、実際のデバイス上での厳格なレビューに耐える実装に変換します。シミュレーターでも開発モードのフラッグシップスマートフォンでもありません。

モバイルはアニメーションに関する3つの点を変え、このスキルのすべてはこれらに従います:

  1. ホバーは存在しません。 Webがホバーに入れるすべてのアフォーダンスは、プレス、位置、または何もなしに存在しなければなりません。
  2. 2つのランタイムがあります。 ワークレット(Reanimated 4)はこれを明示的にします:Reactがレンダリングしアプリロジックが実行されるReact Nativeランタイムと、ワークレットが毎フレーム実行されるUIランタイムです(バックグラウンド作業用のオプションのワーカランタイムもあります)。RNランタイムに触れるアニメーションは、アプリが他に何かをする瞬間にカクつきます。モーションをUIランタイムに保つことがすべての技術です。
  3. ユーザーの指が要素に触れています。 ジェスチャーが主要な入力であるため、割り込み可能性と速度の引き継ぎは装飾ではなく、基本要件です。

運用スタンス

あなたは自らアニメーションを構築するシニアモバイルエンジニアです。判断を下し、理由を1行で述べ、コードを書いてください。モーションオプションをメニューとして提示しないでください。

2つの障害モードがあり、最初のものがより悪いです:

  1. アニメーションさせるべきでないものをアニメーションさせる。 以下のゲートは、時にコード行をゼロにするために存在します。
  2. 正しいものを間違ったスレッドでアニメーションさせる — 毎フレームのsetState、PanResponder、アニメーション化されたheight。開発中はスマートフォンで問題なく見えますが、3年前のAndroidでは20fpsに落ちます。

絶対ルール

  1. 順序通りに実行してください。 ステップ1と2がすべてのゲートとなります。
  2. Reanimatedを使用し、コアのAnimatedは使わないでください。 コアのAnimatedはブリッジを越えずにジェスチャーで駆動できず、useNativeDriverはtransformとopacity以外を拒否します。ReanimatedワークレットはUIスレッドで実行され、JSがビジーでも動作し続けます。
  3. 近似値は使用しないでください。 曲線とスプリング設定は以下のテーブルから取得します。
  4. 動きの低減はアニメーションと一緒に出荷され、後続の対応ではありません。
  5. フィーリングは、サポートする最も遅いデバイスでのリリースビルドで判断されます。 それ以外は検証されたとはみなされません。

構築シーケンス

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

頻度判断
1日100回以上 — タブ切り替え、キーボード開閉、スクロール、設定のトグルアニメーションなし。 プラットフォームデフォルトまたはなし。ここで停止。
1日数十回 — プレスフィードバック、リストナビゲーション、行選択ほぼ知覚できない程度のみ:150ms未満、またはなし
たまに — シート、モーダル、トースト、オンボーディングステップ標準アニメーション
まれ/初回のみ — 成功状態、空状態のイラスト、祝賀ここに楽しさの予算を使う

タブ切り替えでスライドはしません。 タブはピアであり、階層ではありません — スライドは存在しない奥行きを暗示し、ユーザーは1セッションで何十回もその代償を払います。animation: 'none'。

リクエストがこのゲートに合格しない場合は、そう伝え、コードを書かないでください。

2. 目的は何か?

続行する前に1語で名前を付けてください:フィードバック、空間的一貫性、状態表示、急激な変化の防止、説明、または楽しさ(まれな階層のみ)。

名前をつけられない? 構築しないでください。

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

リストを下っていき、最初に適合するもので止まります。

必要性ツール
ジェスチャーなしの状態駆動の変更 — プレス、トグル、色、値を反転Reanimated CSSトランジション(スタイル内のtransitionProperty)
ループ、多段階、またはマウント時に再生され状態変更なしReanimated CSSアニメーション(animationNameキーフレーム)
要素のマウント/アンマウント、またはリストのリフローレイアウトアニメーション(entering / exiting / itemLayoutAnimation)
指が触れるもの、またはスクロールから派生するものuseSharedValue + Gesture + useAnimatedStyle
画面間Expo Routerのネイティブスタックオプション。 これを手動で実装しないでください
自身の画面であるボトムシートpresentation: 'formSheet' — 本物のUISheetPresentationControllerで、無料で正確です
タブバーNativeTabs(expo-router/unstable-native-tabsから) — プラットフォームの実際のタブバー、その振る舞いとトランジションを含む
コンテキストメニュー、長押しプレビューLink.Menu / Link.Preview(Expo Router、iOSのみ) — ネイティブメニューとピーク、JSで再構築しない
大きなタイトルに折りたたまれるヘッダーheaderLargeTitleEnabled をネイティブスタックで使用(iOSのみ;headerLargeTitleは非推奨) — スクロールワークレットではありません
プル・トゥ・リフレッシュRefreshControl — 特徴的なインタラクションの場合のみ手動実装(閾値レシピを参照)
キーボードを追跡するUIreact-native-keyboard-controller — キーボードの実際の位置、フレームごとに、UIスレッド上で
ベクターイラスト、祝賀、空状態Lottie — イラストのみに使用し、UI状態には絶対に使用しない
巨大なアニメーションシーン、自由形式描画@shopify/react-native-skia — キャンバス、ビューヒエラルキー自体がボトルネックになる場合に使用

共有値に手を伸ばすのは、値が連続的または割り込み可能な場合のみです。プレススケールはCSSトランジションであり、ドラッグは共有値です。二状態トグルにワークレットを使用するのは、フェードのためにモーションライブラリをインストールするのと同じモバイル版の大げさな行為です。

依存関係。 npx expo install <package>でインストールします — これはプロジェクトのSDKに一致するバージョンを解決します。通常のnpm installではできません:

必要性パッケージ
アニメーションreact-native-reanimated + react-native-worklets
ジェスチャーreact-native-gesture-handler
ナビゲーション、シート、ネイティブタブ、メニューexpo-router
ハプティクスexpo-haptics
キーボード追従UIreact-native-keyboard-controller(ルートにKeyboardProviderが必要 — キーボードレシピを参照)
イラスト、祝賀lottie-react-native
非常に大きなアニメーションシーン、カスタム描画@shopify/react-native-skia

4. プロパティを選ぶ

  • transformとopacityは無料です。 それ以外はすべてレイアウトパスです。width、height、margin、padding、flex、top、left、gapは、該当ノードとその兄弟ノードの両方に対してフレームごとにYogaを再実行します。
  • 唯一の例外:子要素のない絶対配置要素 — タブピル、プログレスバーの塗りつぶし。フローから外れているため、他は再レイアウトされず、widthをアニメーションさせるとscaleXが台無しにする角丸が維持されます。
  • 決してscale(0)は使わないでください。 scale(0.9–0.97) + opacity: 0から始めてください。現実世界で無から現れるものはありません。
  • transformは配列で順序が重要です — [{ translateY }, { scale }]は移動後にスケールします;逆順にすると移動もスケールされます。乗算が必要でない限り、translateを最初にしてください。
  • Androidの影はelevationであり、elevationをアニメーションさせるとフレームごとに影が再レンダリングされます。 代わりに、事前に影が付いたレイヤーの不透明度をアニメーションさせてください。
  • 決してBlurViewの強度をアニメーションさせないでください。 Androidではフレームごとにぼかしが再レンダリングされます。代わりに、静的なBlurViewの不透明度をクロスフェードさせてください。
  • translateではパーセンテージが使え、要素自身のサイズに対する相対値です — translateY('100%')は、内容に関わらずシートを自身の高さ分移動させます。

5. タイミングかスプリングか

指が関与した場合はスプリングを使用します。 スプリングは割り込みを通過して速度を運びます;タイミング曲線は再起動します。それ以外はすべてタイミングを使用します。

Reanimatedのスプリングは、Appleの2つのデザイナーパラメータを直接受け取ります — この形式を使用し、質量/剛性/減衰は使わないでください:

インタラクション設定
デフォルト収束、オーバーシュートなし{ duration: 400, dampingRatio: 1 }
ドラッグ後の再配置/スナップバック{ duration: 400, dampingRatio: 0.8, velocity }
シート、ドロワー{ duration: 300, dampingRatio: 0.8, velocity }
ハードエッジを超えてはいけない場合overshootClamping: trueを追加

ジェスチャーが運動量を運んだ場合のみバウンスします。 フェードインしたメニューでのオーバーシュートは違和感があります;弾いたカードでのオーバーシュートは正しく感じられます。

イージング、指が触れていないすべてのものに対して:

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

UIでは決してease-inを使用しないでください。 ゆっくり始まり、ユーザーが見ている正確な瞬間を遅らせます。Reanimatedの組み込みはCSSと同じくらい弱いです — これらを使用してください:

import { Easing } from 'react-native-reanimated';

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // UI用の強いease-out
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // 画面上の動き
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // iOSシート曲線

持続時間:

要素持続時間
プレスフィードバック100–150ms
トグル、チップ、小さな状態変化150–200ms
シート、モーダル、ドロワースプリング、~300ms知覚時間
画面トランジションプラットフォームデフォルト — 上書きしないでください

モバイルUIアニメーションは、ウェブと同じく300ms未満に抑えます。プラットフォーム自身のトランジションはそれより長いです(iOSプッシュは350ms);ナビゲーションではプラットフォームに合わせ、それ以外ではそれを上回ります。

6. JSスレッドから遠ざける

これがモバイル固有の技術であり、ほとんどのReact Nativeモーションが死滅する場所です。

  • ジェスチャーやスクロールハンドラーから決してsetStateを呼ばないでください。 フレームごとに1回のReactレンダリングは、RNアプリにおけるジャンクの最大の原因です。共有値 → useAnimatedStyleを使い、Reactは一切再レンダリングしません。
  • onUpdateやスクロールハンドラー内でRNランタイムにスケジュールバックしないでください。 react-native-workletsのscheduleOnRN(fn, ...args)(非推奨のrunOnJS(fn)(...args)のReanimated 4での置き換え)はRNランタイム呼び出しをキューに入れますが、onUpdate内では毎秒60〜120回になります。これはonEndか、値が閾値を超えた時に発火するuseAnimatedReactionに属します。
  • レンダリング中に共有値を読み取らないでください(JSX内でのtranslateY.get())。それは決して更新されないスナップショットであり、静かに同期がずれます。レンダリング中に書き込んでもいけません — 再調整途中に発火し、意図しない再レンダリングが書き込みを再生します。共有値にはワークレット、ハンドラー、エフェクト内でのみ触れてください。
  • .get() / .set()を使用し、.valueは使わないでください。 同じAPIですが、直接の.valueアクセスはReactコンパイラが認識できない形式です — Reanimatedのドキュメントではget/setをコンパイラセーフな方法と呼んでいます。setは関数型更新も受け付けます:sv.set((v) => v + 1)。
  • ワークレットから呼び出される関数には最初の行として'worklet'が必要です、さもなければデバイス上で実行時にスローされますが、デバッガーでは正常に動作します。

7. プレス、ホバーではない

ウェブのすべてのホバーアフォーダンスは、移植ではなく再設計する必要があります。

  • プレスイン時にフィードバック、プレスアウト時にコミット。 タップが完了するまで何も表示しないのは死んだように感じます — これがユーザーが実際に知覚するレイテンシです。
  • プレス可能な要素にはscale: 0.97を100–150msで、Pressable + CSSトランジションを使用します。scaleはラベルやアイコンも一緒に動かし、それが物理的に感じさせる要因です。
  • 最小タッチターゲットは44×44pt(Androidでは48dp)。ビジュアルが小さい場合はhitSlopを追加してください — ビジュアルを大きくしないでください。
  • **pressRetentionOffset**を使用して、数ピクセル指がずれてもユーザーが意図したプレスがキャンセルされないようにします。
  • AndroidのリップルはMaterialスタイルのアプリでのみ使用します。 カスタムデザインのアプリでは、両プラットフォームで同じスケールを使用する方が、一方だけにリップルを入れるよりも一貫性があります。

8. ハプティクス

モバイルにはウェブにはない感覚があります。控えめに使えばアプリを高級に感じさせる要素になります;あらゆる場所で使えばユーザーはオフにします。

瞬間呼び出し
値がステップを超える — ピッカー、スライダーデテント、セグメントコントロールHaptics.selectionAsync()
何かが所定の位置にスナップする、シートデテントがかかる、ドラッグがコミットされるHaptics.impactAsync(ImpactFeedbackStyle.Light)
重いオブジェクトが着地する、破壊的なアクションが発生するHaptics.impactAsync(ImpactFeedbackStyle.Medium)
操作が成功または失敗したHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

3つのルールがあり、絶対的です:

  • ビジュアルと同じフレームで。 アニメーションに遅れるハプティクスはフィードバックではなくグリッチとして読み取られます。因果関係のある瞬間 — デテントがかかる時 — に発火させ、アニメーションが終了した時ではありません。
  • ユーザーアクションごとに1回。 スクロール時には決して使用せず、フレームごとにも使用せず、ユーザーが引き起こさなかったエントランスアニメーションにも使用しません。
  • 決して唯一のフィードバックにしないでください。 多くのユーザーはハプティクスをシステム全体でオフにしており、ほとんどのAndroidハードウェアでは無音です。ビジュアルだけで独立して機能する必要があります。

ワークレットからは、ハプティクスはRNランタイムにスケジュールバックする必要があります:scheduleOnRN(Haptics.selectionAsync)。

9. 動きの低減とアクセシビリティ

import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';

const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);

// または各アニメーションに判断させる
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

動きの低減はより少なく、より穏やかにを意味し、ゼロではありません:状態変化を説明する不透明度と色の変更は維持し、移動、スケール、パララックス、オーバーシュートは削除します。画面トランジションはanimation: 'fade'になります。

テキストのスケール。 allowFontScalingはデフォルトでオンであるため、デフォルトのフォントサイズで測定した高さは200%では正しくありません。ハードコードされた高さにアニメーションさせず、onLayoutで測定するか、代わりにtransformをアニメーションさせてください。

静かにモーションを壊すセットアップ

「アニメーションが実行されない」ときは、まずこれらを確認してください:

  • Expoを通じてインストールし、バージョンがSDKと一致するように:npx expo install react-native-reanimated react-native-worklets。Expoプロジェクトでは、babel-preset-expoが自動的にワークレットBabelプラグインを設定します — babel.config.jsのステップは不要です。そのプリセットがないベアRNプロジェクトのみ、手動でプラグインを追加します...

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

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.

関連スキル