Communitygithub.com

therts649-ai/Claude-Skills

Expo および React Native アプリケーション向けのアニメーション構築スキル。実機での「感触」を最優先し、Reanimated、Gesture Handler、Expo Router、exp-haptics を用いて、アニメーションすべき箇所、利用スレッド、プロパティ、スプリングまたはタイミング、ジェスチャーの引き継ぎ、劣化動作の判断を順次行いながら実装します。

Claude-Skills とは?

このスキルは、Expo および React Native アプリケーションにおいて、単なる視覚効果ではなく「実機での感触」を最優先したアニメーションを構築するための厳格な設計手法を提供します。Emil Kowalski 氏のアニメーションフィロソフィーに基づき、アニメーションの要否判断から始まり、Reanimated(UIスレッド)、Gesture Handler(ジェスチャー)、Expo Router(画面遷移)、exp-haptics(触覚フィードバック)を適切に組み合わせます。本スキルの核心は、モバイルならではの制約(ホバー無効、JSスレッドとUIスレッドの分離、指による操作の割り込み)を理解し、`useSharedValue`と`useAnimatedStyle`を駆使してフレームレートを維持しつつ、スプリングアニメーションやイージングカーブの厳密な設定、ハプティクスの適切なタイミング、動きの抑制設定への対応まで網羅します。Cline や Cursor などの AI エージェントで利用可能で、開発者にアニメーション実装の判断を委ねず、決断とコード生成をワンストップで行います。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/therts649-ai/Claude-Skills/tree/HEAD/plugins/emil-design/skills/animate-expo

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

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

ドキュメント

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

初期応答

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

Expo と React Native で、実機で「感触」が正しいアニメーションを構築する準備ができました。私の知識は Emil Kowalski のアニメーションフィロソフィーに基づいています。

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

これは React Native 向けの構築スキルです。モーションのリクエストを、シミュレーターや開発モードのハイエンド端末ではなく、実機での厳格なレビューに耐える実装に変換します。

モバイルはアニメーションに関して3つの点が異なり、このスキルのすべてはこれらに基づいています:

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

運用姿勢

あなたは自らアニメーションを実装するシニアモバイルエンジニアです。判断を下し、その理由を一文で述べ、コードを書いてください。モーションの選択肢をメニューとして提示しないでください。

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. 目的は何か?

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

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

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

下に進み、最初に適合するもので止まります。

ニーズツール
ジェスチャーなしの状態駆動変更 — プレス、トグル、色、値の切り替えReanimated CSS transition(スタイル内の transitionProperty)
ループ、多段階、または状態変更なしでマウント時に再生Reanimated CSS animation(animationName キーフレーム)
要素のマウント/アンマウント、またはリストの再フローLayout animations(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 トランジションです; ドラッグは共有値です。2状態トグルにワークレットを使用することは、フェードインにモーションライブラリをインストールするのと同じです。

依存関係。 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 もスケールされます。乗算が必要でない限り、translate を最初に配置します。
  • Android の影は elevation であり、elevation をアニメーションすると毎フレーム影が再レンダリングされる。 代わりに、事前に影を付けたレイヤーの opacity をアニメーションします。
  • BlurView の intensity は決してアニメーションしない。 Android では毎フレームブラーを再レンダリングします。代わりに、静的 BlurView の opacity をクロスフェードします。
  • パーセンテージは translate で機能し、要素自身のサイズに基づきます — translateY('100%') は、内容に関係なくシートを自身の高さ分だけ移動します。

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

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

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

インタラクション設定
デフォルトの収束、オーバーシュートなし{ 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
シート、モーダル、ドロワーspring、約300ms 知覚
画面遷移プラットフォームデフォルト — 上書きしない

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

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

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

  • ジェスチャーまたはスクロールハンドラから setState を決して呼ばない。 フレームごとの 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 });

動きの抑制とは より少なく、より穏やかに であり、ゼロではありません: 状態変化を説明する opacity と色の変更は維持し、平行移動、スケール、パララックス、オーバーシュートは削除します。画面遷移は 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 4 individual skills — each has its own dedicated page.

関連スキル