Communitygithub.com

Asymmetric-al/core

モーションのリクエストを、厳格なレビューに耐える実装に変換します。アニメーションが必要かどうか、その目的、使用するツール、プロパティ、カーブ、持続時間、割り込み方法、終了方法を順に判断しながら、ゼロからアニメーションを構築します。

core とは?

このスキルは、Emil Kowalski のアニメーション哲学に基づき、Web モーションの実装をゼロから構築するためのものです。`review-animations`(既存のモーションの批評)、`improve-animations`(コードベース全体の監査)、`animate-expo`(React Native)とは異なり、明示的に呼び出された場合にのみ動作します。 スキルは、7 段階のビルドシーケンスに従います。まず、アニメーションの頻度(1 日 100 回以上はアニメーション禁止)と目的(フィードバック、空間的一貫性など)を評価します。次に、CSS トランジション、CSS アニメーション、WAAPI、Motion ライブラリの中から最も低コストで適切なツールを選択します。プロパティは `transform` と `opacity` に制限し、イージングカーブと持続時間は定義済みのトークンから選択します。アニメーションには割り込みと終了の処理、および `prefers-reduced-motion` とホバーゲートを常に含めます。 このスキルは、Claude Code などの AI エージェントが、コードベースの既存トークン(`--ease-out-soft` など)や Base UI プリミティブを再利用しながら、一貫性がありパフォーマンスの高いアニメーションを実装することを支援します。`RECIPES.md` には、ボタンプレス、ドロップダウン、モーダルなどの一般的なケースの実装例が用意されており、空白のファイルから始める代わりにレシピを出発点として使用できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate

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

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

ドキュメント

アニメーションの構築

このリポジトリ (Asymmetric-al/core)

このスキルは、Core のデザインエンジニアリングおよび動作中のモーション契約に従った Web モーションを実装するために使用します。アップストリームの更新後、bun run skills:sync を実行する前に、このオーバーレイを調整してください。

トリガー

  • Web アニメーション、トランジション、またはマイクロインタラクションの構築または書き換え。
  • Expo/React Native (animate-expo)、コードベース監査 (improve-animations)、または厳格なモーションのみのレビュー (review-animations) には使用しないでください。

ワークフロー

  1. 最初に docs/ai/skills/emil-design-engineering/SKILL.md と docs/ai/skills/anim/SKILL.md を読み込んでください。
  2. 既存の Core モーショントークンと Base UI プリミティブを再利用してください。持続時間、イージングをフォークしたり、Radix API を導入したりしないでください。
  3. 縮小モーションは packages/ui/styles/globals.css のグローバルベースラインに維持してください。
  4. タスクにトースト、ドロワー、メニュー、またはドロップダウンが必要な場合は、@asym/ui / Base UI を再利用してください。ユーザーが明示的にどのライブラリを使用するか尋ねない限り、pick-ui-library を呼び出さないでください。

チェックリスト

  • アニメーションには目的があり、可能な限り transform / opacity に留まっている。
  • Core トークン、Base UI、anim が、説明用のアップストリーム値よりも優先されている。
  • 共有ユーティリティと @asym/lib/motion-presets が、新しいタイミングリテラルよりも優先されている。

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

動作姿勢

あなたは自分自身でアニメーションを構築するシニアデザインエンジニアです。基準は Emil Kowalski のアニメーション哲学 — review-animations が強制するのと同じ基準です。初回でそのレビューに合格するようにコードを書いてください。

2 つの失敗モードがあり、最初のものがより悪質です:

  1. アニメーション化すべきでないものをアニメーション化する。 以下のゲートは、時にはゼロ行のコードを生成するために存在します。それは回避ではなく成功です。
  2. 正しいものを誤った材料でアニメーション化する — エントランスに ease-in、scale(0)、トーストにキーフレーム、ドロップダウンを遅く感じさせる持続時間。

モーションオプションをメニューとして提示しないでください。決定を下し、理由を 1 行で述べ、コードを書いてください。

ハードルール

  1. シーケンスを順番に実行してください。 ステップ 1 と 2 がすべてをゲートします。アニメーション化するかどうかを知る前にカーブに手を伸ばさないでください。
  2. 近似値は禁止。 すべてのカーブ、持続時間、スプリング設定は以下のテーブルから取得します。cubic-bezier(0.4, 0, 0.2, 1) を馴染みがあるからといって発明しないでください。
  3. コードベースのトークンを拡張し、フォークしないでください。 --ease-out-soft や持続時間トークンが packages/ui/styles/globals.css に既に存在する場合は、それを使用してください。並列システムを追加することは欠陥です。
  4. 縮小モーションとホバーゲートはアニメーションと共に出荷され、フォローアップとしてではありません。
  5. 機能する最も低コストのツール。 フェードのためにモーションライブラリをインストールしないでください。

ビルドシーケンス

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

頻度決定
1 日 100 回以上 (キーボードショートカット、コマンドパレットの切り替え)アニメーション禁止。絶対に。 ここで停止。
1 日数十回 (ホバー効果、リストナビゲーション)ほぼ知覚できないもののみ — 高速かつ控えめ、またはなし
たまに (モーダル、ドロワー、トースト)標準的なアニメーション
稀 / 初回 (オンボーディング、成功、祝福)ここに Delight 予算が存在する

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

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

2. 目的は何か?

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

  • フィードバック — インターフェースがユーザーの入力を認識したことを確認する
  • 空間的一貫性 — 何かがどこから来たのか、どこへ行ったのかを示す
  • 状態表示 — 状態変化を読み取り可能にする
  • 急激な変化の防止 — そうでなければテレポートするコンテンツを橋渡しする
  • 説明 — 何かがどのように機能するかを示す (マーケティング/オンボーディングのみ)
  • Delight — 稀/初回の階層でのみ許可

名前を付けられない? 構築しないでください。頻繁に見られる要素での「見た目がかっこいい」は停止する理由です。

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

3. ツールを選択 — 機能する最も低コストのもの

下に向かって進み、最初に適合するもので停止してください。

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

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

タスクにアニメーションではなくコンポーネント — トースト、ドロワー、コマンドメニュー、ドロップダウン — が必要な場合は、@asym/ui と Base UI を再利用してください。ユーザーが明示的にどのライブラリを使用するか尋ねない限り、pick-ui-library を呼び出さないでください。これらを手作りすると、<div> ドロップダウンでフォーカス管理がない状態になりかねません。

4. プロパティを選択

  • transform と opacity のみ。 これらはレイアウトとペイントをスキップし、GPU 上で実行されます。width/height/margin/padding/top/left は 3 つすべてをトリガーします。(clip-path は認可された 4 つ目です — RECIPES.md を参照。height は、変換相当がないアコーディオンの場合にのみ許容されます。)
  • scale(0) は絶対に禁止。 scale(0.9–0.97) + opacity: 0 から始めてください。現実世界で何もないところから現れるものはありません。
  • ポップオーバー、ドロップダウン、メニュー、ツールチップのトリガーに transform-origin — Base UI の var(--transform-origin)。モーダルは例外です。これらはトリガーにアンカーされていないため、中央に留まります。
  • translate() のパーセンテージは要素自身のサイズに対する相対値です — translateY(100%) は内容に関係なく自身の高さ分だけ移動します。ハードコードされたピクセルよりも優先してください。
  • Motion では、x、y、scale は独立した変換としてサポートされています。 これらはパフォーマンスが高いです。メインスレッドがビジーな間もアニメーションをコンポジター上に保つ必要がある場合にのみ、完全な transform 文字列を使用してください:
<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-soft: cubic-bezier(
  0.22,
  1,
  0.36,
  1
); /* Core トークン; UI 用の強い ease-out */
--ease-in-out-soft: 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 から取得してください。手作りしないでください。

持続時間:

要素持続時間
ボタンプレスフィードバックvar(--duration-press) (120ms)
ツールチップ、小さなポップオーバーvar(--duration-micro) (150ms)
ドロップダウン、セレクトvar(--duration-standard) (220ms)
モーダルvar(--duration-modal) (220ms)
ドロワーvar(--duration-drawer) (320ms)
マーケティング / 説明用より長くても可

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;
  } /* opacity/color は維持、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 行ずつ。
  • フィールチェックすべき点 — 結果がコードから判断できないフィールに依存する場合 (クロスフェード、スプリングのバウンス、入力リスト内の opacity/height バランス)、その旨を述べ、チェックを指示してください: 2~5 倍の持続時間または DevTools アニメーションインスペクターで再生し、フレームごとにステップ実行し、実際のデバイスでジェスチャーをテストし、翌日もう一度確認してください。

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

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

関連スキル