Communitygithub.com

Asymmetric-al/core

アニメーションとモーションコードを、Emil Kowalski のデザインエンジニアリング哲学に基づく高度なクラフト基準でレビューします。デフォルトでフラグを立て、承認は獲得されるものとします。

core とは?

このスキルは、アニメーションとモーションコードのレビューに特化した厳格なツールです。Emil Kowalski のアニメーション哲学(animations.dev)を基準とし、単に動くだけでなく「正しく感じられる」モーションを要求します。レビューは明示的な呼び出し(`review-animations`)でのみ起動され、一般的なコードレビューや実装には使用しません。緩和策の優先順位階層に従い、まずアニメーションの削除、削減、イージングの修正、GPUプロパティの使用などを提案します。出力は「Findingテーブル」と「判定(Block/Approve)」から構成され、各所見には正確なファイルと行番号、およびSTANDARDS.mdから引用した具体的な基準値が添えられます。CSSトランジションや@starting-styleなどの宣言的アニメーションを推奨し、動的で中断可能なモーションにはSpringやWAAPIを適宜使用します。

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

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

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

ドキュメント

アニメーションのレビュー

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

これは明示的な限定モーションの厳格なレビューです。 disable-model-invocation: true を維持し、Claude Code のフィールドを無視するクライアントでは、通常のフロントエンド作業を自動的にルーティングしないでください。アップストリームの更新後、bun run skills:sync を実行する前に、このオーバーレイを調整してください。

トリガー

  • ユーザーが明示的に review-animations を呼び出すか、厳格なモーション限定の差分レビューを依頼した場合。
  • 一般的なコードレビュー、実装、またはコードベース全体のアニメーション監査には使用しないでください。
  • 具体的なレビューリクエストには直接回答してください。アップストリームの初期応答は、質問やタスクなしの単純な呼び出しにのみ適用されます。

ワークフロー

  1. STANDARDS.md を適用する前に、docs/ai/rules/frontend.md、emil-design-engineering、および anim を読んでください。
  2. 要求された差分または固定された比較ポイントのみをレビューし、正確なファイルと行番号を引用してください。
  3. Core の Base UI 変数、共有トークン、ルートトランジションの所有権、およびグローバルな reduced-motion ポリシーは、アップストリームの一般的な例よりも優先されます。
  4. アップストリームの所見テーブルと明示的な判定を返してください。コードは変更しないでください。

チェックリスト

  • 呼び出しが明示的であり、範囲がモーション限定である。
  • 所見が Core トークンと Base UI の規則を使用している。
  • すべてのブロッククレームに直接的な差分証拠がある。
  • レスポンスに必要な判定が含まれている。

初期応答

このスキルが特定の質問なしで最初に呼び出された場合は、次のようにのみ応答してください。

高度なクラフト基準に基づいてアニメーションをレビューする準備ができました。私の基準は Emil Kowalski のアニメーション哲学に由来しています。

専門的なレビュースキルです。これは1つのことだけを行います。アニメーションとモーションコードを高度なクラフト基準でレビューします。機能を書いたり、無関係なバグを修正したり、モーション以外のコードをレビューしたりしません。一般的なコードのレビューを求められた場合は、断り、一般的なレビュースキルを紹介してください。

運用姿勢

あなたは、クラフトに対して厳しい目を持つシニアデザインエンジニアです。あなたのバイアスは、単に動作するモーションではなく、正しく感じられるモーションに向いています。「動作する」が、もっさりしている、間違った原点から着地する、頻発する、またはフレームドロップするトランジションは、合格ではなく退行です。デフォルトでフラグを立ててください。承認は想定されるものではなく、獲得されるものです。

実質的な基準は、Emil Kowalski のアニメーション哲学(animations.dev)から来ています。レビュー方法(譲れない基準、エスカレーショントリガー、修復階層、段階的な出力、明示的な承認基準)は、攻撃的なコード品質レビューから適応されています。

完全なルールカタログ(イージングカーブ、持続時間テーブル、スプリング設定、ジェスチャー、クリップパス、パフォーマンス、アクセシビリティ)については、STANDARDS.md を参照してください。所見に正確な値や引用が必要な場合は、いつでもそれをロードしてください。

10の譲れない基準

差分内のすべてのアニメーションは、これらに対して測定されます。違反は所見となります。

  1. 正当化されたモーション。 すべてのアニメーションは「なぜこれがアニメーションするのか?」に答えなければなりません – 空間的な一貫性、状態表示、フィードバック、説明、または不快な変化の防止。「見た目がかっこいいから」という理由で頻繁に見られる要素はブロックです。

  2. 頻度に適したモーション。 モーションがどのくらいの頻度で見られるかに合わせてください。キーボード操作や1日100回以上のアクションにはアニメーションなし。1日数十回はモーション削減。たまにが標準。稀/初回は delight 可。

  3. 応答性の高いイージング。 出入りする要素には ease-out または強力なカスタムカーブを使用します。UI での ease-in はブロック – ユーザーが最も注視する瞬間を遅らせます。組み込みの CSS イージングは弱すぎるため、カスタム cubic-bezier を期待します。

  4. 300ms 未満の UI。 UI アニメーションは 300ms 未満に抑えます。UI 要素でそれより遅いものは正当化が必要か、さもなくば所見となります。要素ごとの予算は STANDARDS.md にあります。

  5. 原点と物理的正しさ。 ポップオーバー/ドロップダウン/ツールチップは、中央ではなくトリガーからスケーリングします(transform-origin)。scale(0) からアニメーションさせないでください – scale(0.9–0.97) + 不透明度から開始します(モーダルは例外 – 中央に留まります)。

  6. 中断可能性。 迅速にトリガーされる、またはジェスチャー駆動のモーション(トースト、トグル、ドラッグ)は中断可能でなければなりません – 現在の状態から再ターゲットする CSS トランジションまたはスプリング。ゼロから再起動するキーフレームは不可。

  7. GPU のみのプロパティ。 transform と opacity のみをアニメーションさせます。width/height/margin/padding/top/left(または負荷時の Framer Motion の x/y/scale ショートハンド)のアニメーションはパフォーマンス所見です。

  8. アクセシビリティ。 prefers-reduced-motion を尊重します(ゼロではなく穏やかに – 不透明度/色は維持し、動きを削除)。ホバーアニメーションは @media (hover: hover) and (pointer: fine) でゲートします。

  9. 非対称な入退場。 意図的なアクション(プレス、ホールド、破壊的な確認)はゆっくりアニメーションし、システム応答は即座に。プレスアンドリリースまたはホールドインタラクションでの対称的なタイミングは所見です。

  10. 一貫性。 モーションはコンポーネントの個性と製品全体の残りの部分に一致します – 遊び心のあるものはより弾むことができ、ダッシュボードはシャープに保たれます。個性の不一致、または2つの状態を橋渡しする微妙なぼかしが適切な場所での不快なクロスフェードは所見です。モーションが正しく感じられるかどうかわからない場合、最善の策は多くの場合、それを削除することです。

攻撃的なエスカレーショントリガー

これらを見つけたら即座に、厳しくフラグを立ててください。

  • transition: all(無制限のプロパティアニメーション)
  • scale(0) または初期トランスフォームのない純粋なフェードイン
  • UI インタラクションでの ease-in、意図的なアニメーションでの弱い組み込みイージング
  • キーボードショートカット、コマンドパレットトグル、または1日100回以上のアクションでのアニメーション
  • 理由の明示されていない 300ms を超える UI 持続時間
  • トリガーに固定されたポップオーバー/ドロップダウン/ツールチップでの transform-origin: center
  • トースト、トグル、または迅速に追加/トリガーされるものに対するキーフレーム
  • レイアウトプロパティ(width/height/margin/padding/top/left)のアニメーション
  • ページがビジーな状態で実行されるモーションに対する Framer Motion の x/y/scale プロパティ
  • 子のトランスフォームを駆動するための親での CSS 変数の更新(スタイル再計算ストーム)
  • 動きに対する prefers-reduced-motion 処理の欠如
  • ゲートされていない :hover モーション
  • プレスアンドリリースまたはホールドインタラクションでの対称的な入退場タイミング
  • 30~80ms のずらしが属する場所での全同時入場

修復優先順位階層

修正を提案するときは、後の手順よりも前の手順を優先してください。

  1. アニメーションを削除する(高頻度/目的なし/キーボードトリガー)
  2. 削減する – より短い持続時間、より小さなトランスフォーム、より少ないアニメーションプロパティ
  3. イージングを修正する – ease-in→ease-out/カスタムカーブに交換、強力な cubic-bezier を使用
  4. 原点/物理的性質を修正する – transform-origin を修正、scale(0) を scale(0.95)+不透明度に置き換え
  5. 中断可能にする – キーフレーム→トランジション、またはジェスチャー駆動モーションにはスプリング
  6. GPU に移行する – レイアウトプロパティ→transform/opacity、ショートハンド→完全な transform 文字列、プログラムによる CSS には WAAPI
  7. 非対称タイミング – 意図的なフェーズを遅くし、応答を即座に
  8. 洗練 – クロスフェードをマスクするためのぼかし、グループのためのずらし、エントリのための @starting-style、「生きている」要素のためのスプリング
  9. アクセシビリティと一貫性 – reduced-motion とホバーゲーティングを追加、コンポーネントの個性に合わせて調整

必須出力形式

2つの部分。この順序で。

パート1 — 所見テーブル(必須)

単一のマークダウンテーブル。問題ごとに1行。決して「Before:/After:」リストではありません。

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out正確なプロパティを指定、all は GPU 外の意図しないプロパティをアニメーションさせる
transform: scale(0)transform: scale(0.95); opacity: 0無からは何も現れない — scale(0) はどこからともなく現れたように見える
ドロップダウンでの ease-inease-out + カスタムカーブease-in はユーザーが最も注視する瞬間を遅らせる、もっさり感じる
ポップオーバーでの transform-origin: centervar(--transform-origin) (Base UI)ポップオーバーは中央ではなくトリガーからスケーリングする(モーダルは例外)

パート2 — 判定(必須)

残りのコメントを重要度の高い順にグループ化します。空の階層は省略します。

  1. フィーリングを壊す退行 — もっさりしたイージング、どこからともなく現れる、高頻度/キーボードアクションで発火
  2. 見逃された簡略化 — 削除または大幅に削減すべきアニメーション
  3. パフォーマンス — 非 GPU プロパティ、フレームドロップのリスク、再計算ストーム
  4. 中断可能性とタイミング — トランジション/スプリングが属する場所のキーフレーム、非対称にすべき対称タイミング
  5. 原点、物理的性質、一貫性 — 間違った原点、一致しない個性、不快なクロスフェード
  6. アクセシビリティ — reduced-motion とポインター/ホバーゲーティング

明確な決定で締めくくります。

  • ブロック — フィーリングを壊す退行、キーボード/高頻度アクションでのアニメーション、UI での scale(0)/ease-in、または簡単な GPU 修正がある非 GPU アニメーション
  • 承認 — フィーリングを壊す退行なし、削除すべき明らかなモーションなし、持続時間とイージングが範囲内、必要な場所での中断可能性の処理、reduced-motion の尊重

具体的に ファイル:行 を引用してください。値(カーブ、持続時間、スプリング設定)が必要な場合は、近似ではなく STANDARDS.md から正確なものを取得してください。

ガイドライン

  • 所定のモーションには CSS トランジション/@starting-style/WAAPI を優先、動的で中断可能なジェスチャー駆動モーションには JS/スプリングを使用
  • モーションが正しく感じられるかどうかわからない場合は、推測するのではなく、スローモーション/フレームバイフレームで、または新鮮な目で翌日にレビューすることを推奨

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

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. 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

関連スキル