Communitygithub.com

CharbelElBateh/personal-website

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

personal-website とは?

このスキルは、モーションコードのレビューに特化したツールです。Emil Kowalskiのアニメーション哲学(animations.dev)を基準とし、厳格な10の必須基準に基づいてアニメーションを評価します。対応プラットフォームはClaude CodeなどのAIエージェントであり、開発者がプルリクエスト内のアニメーションの質を保証するために使用します。デフォルトは問題を積極的にフラグ付けする姿勢で、承認は獲得されるものです。アニメーションの正当性、頻度の適切さ、イージング、持続時間(UIは300ms未満)、原点の正しさ、中断可能性、パフォーマンス(transformとopacityのみ)、アクセシビリティ(prefers-reduced-motion対応)、非対称な出入り、一貫性の10項目をチェックし、違反は即座に指摘します。問題の修正提案は「アニメーションの削除」「軽減」「イージング修正」「原点修正」「中断可能化」「GPU移動」「非対称タイミング」「洗練」「アクセシビリティと一貫性」の優先順位で行われ、結果は問題一覧表と影響度別の評価、さらにBlock/Approveの明確な判断として出力されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/review-animations

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

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

ドキュメント

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

初期応答

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

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

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

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

運用姿勢

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

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

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

10の譲れない基準

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

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

  2. 頻度に適したもの。 モーションを、それが見られる頻度に合わせてください。キーボード起因および1日100回以上のアクションにはアニメーションなし。1日数十回には低減されたモーション。時々は標準。まれ/初回のみは喜びを持たせてもよい。

  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) + opacityから始めてください(モーダルは例外 — 中央に留まります)。

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

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

  8. アクセシビリティ。 prefers-reduced-motionが尊重されます(完全停止ではなく、より穏やかに — opacity/colorは維持し、動きを削除)。ホバーアニメーションは@media (hover: hover) and (pointer: fine)の背後にゲートされます。

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

  10. 一貫性。 モーションはコンポーネントの性格と製品の残りの部分に一致します — 遊び心のあるものはバウンスが強くてもよく、ダッシュボードはきびきびと保ちます。性格の不一致、または2つの状態を橋渡しする微妙なぼかしが必要な場面での不快なクロスフェードは所見です。モーションが正しく感じられるかどうか確信が持てない場合、最も強力な手はしばしばそれを削除することです。

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

これらを見つけたら、即座に強くフラグ付けします:

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

修正の優先順位階層

修正を提案する際は、後のものよりも前のものを優先してください:

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

必須出力フォーマット

2つのパート。この順序で。

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

単一のマークダウンテーブル。問題ごとに1行。「Before:/After:」リストは絶対に使用しないでください。

Before (変更前)After (変更後)Why (理由)
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 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

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

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

関連スキル