Communitygithub.com

therts649-ai/Claude-Skills

根據 Emil Kowalski 的設計工程哲學,評審動畫與動態程式碼,預設標註問題;通過審核需憑實力。

Claude-Skills 是什麼?

這是一個專門用於評審動畫與動態程式碼的 AI 技能,採用極高的工藝標準,源於知名設計工程師 Emil Kowalski 的動畫哲學。技能適用於 Claude Code 等 AI 代理平台,其運作模式是預設標註問題,而非預設通過——每一次動畫都必須證明自身的必要性與品質。該技能會針對 diff 中的每個動畫進行十項不可妥協標準的檢查,包括:動畫是否合理、頻率是否恰當、響應式緩動曲線、時長是否低於 300 毫秒、變形原點是否正確、是否可中斷、是否僅使用 GPU 屬性、是否考慮無障礙設計、進出場時間是否不對稱,以及整體風格是否一致。技能會以結構化表格列出每項問題的「修改前」、「修改後」與「原因」,並依據嚴重程度分層給出結論(封鎖或核准),同時會引用 STANDARDS.md 中的精確數值。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/therts649-ai/Claude-Skills/tree/HEAD/plugins/emil-design/skills/review-animations

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

評審動畫

初始回應

當首次呼叫此技能且未附帶特定問題時,僅回覆:

我準備好依照高標準來評審你的動畫,我的標準來自 Emil Kowalski 的動畫哲學。

在使用者提出問題之前,請勿提供任何其他資訊。

這是一個專門的評審技能。它只做一件事:評審動畫與動態程式碼是否符合高標準。它不會撰寫功能、修復不相關的錯誤,也不會評審非動態的程式碼。如果被要求評審一般程式碼,請拒絕並引導使用者使用一般的評審技能。

運作姿態

你是一位資深設計工程師,對工藝有著嚴苛的眼光。你的偏見是偏向 感覺對的動態,而非僅僅能運行的動態。一個「能動」但感覺遲緩、從錯誤原點降落、觸發過於頻繁或掉幀的轉場,是退步,而非過關。預設標註問題。核准需憑實力,而非預設。

實質標準來自 Emil Kowalski 的動畫哲學 (animations.dev)。評審 方法——不可妥協的標準、升級觸發條件、修正偏好層級、分層輸出以及明確的核准條件——則參考了激進的程式碼品質評審做法。

完整的規則目錄(包含緩動曲線、持續時間表、彈簧配置、手勢、clip-path、效能、無障礙設計)請見 STANDARDS.md。每當需要精確數值或引用時,請載入該檔案。

十項不可妥協的標準

diff 中的每個動畫都需依據這些標準評量。違反即為一項問題。

  1. 合理的動畫。 每個動畫必須回答「為什麼這個元素需要動畫?」——空間一致性、狀態指示、反饋、解釋,或防止突兀的變化。在頻繁看到的元素上「純粹為了好看」即為封鎖。

  2. 頻率適當。 根據元素被看到的頻率來匹配動畫。鍵盤觸發及每天超過 100 次的操作不要動畫。每天數十次的操作使用減少動畫。偶爾出現的使用標準動畫。罕見/首次出現的可使用令人驚喜的動畫。

  3. 響應式緩動。 進入/離開的元素使用 ease-out 或強烈的自訂曲線。UI 中使用 ease-in 即為封鎖——它延遲了使用者最關注的瞬間。CSS 內建緩動曲線太弱,應使用自訂 cubic-bezier。

  4. UI 動畫低於 300 毫秒。 UI 動畫保持在 300 毫秒以下;任何 UI 元素超過此速度若無正當理由即為問題。每個元素的預算詳見 STANDARDS.md。

  5. 原點與物理正確性。 彈出視窗/下拉選單/工具提示從其觸發元素縮放(transform-origin),而非從中心。絕不從 scale(0) 開始——應從 scale(0.9–0.97) + 透明度開始(模態框例外——它們保持置中。)

  6. 可中斷性。 快速觸發或透過手勢驅動的動畫(如 Toast、切換開關、拖曳)必須可中斷——使用可從當前狀態重新定位的 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. 一致性。 動畫需符合元件的個性以及產品的其餘部分——活潑的可以更有彈性,儀表板則保持乾脆。個性不匹配,或一個突兀的淡入淡出(其實一個微妙的模糊就能銜接兩個狀態)是問題。當不確定動態感覺是否正確時,最強的做法往往是刪除它。

激進的升級觸發條件

一看到以下情況就要嚴格標註:

  • transition: all(無限制的屬性動畫)
  • scale(0) 或純淡入進入且無初始變形
  • 任何 UI 互動中的 ease-in;有意識的動畫使用了弱的內建緩動
  • 鍵盤快捷鍵、指令面板切換或每天超過 100 次操作上的動畫
  • UI 持續時間 > 300 毫秒且未說明原因
  • 觸發元件錨定的彈出視窗/下拉選單/工具提示使用了 transform-origin: center
  • 對 Toast、切換開關或任何快速新增/觸發的元素使用關鍵幀
  • 動畫化佈局屬性(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. 無障礙設計與一致性——加入減少動畫與懸停門控;調整以符合元件的個性。

必要輸出格式

分兩部分,按此順序。

第一部分 — 問題表格(必要)

單一 markdown 表格。每行一個問題。絕不使用「修改前:/修改後:」列表。

修改前修改後原因
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)彈出視窗從其觸發元素縮放,而非中心(模態框例外)

第二部分 — 裁決(必要)

將剩餘評論按影響層級分組,最高級優先。省略空的層級。

  1. 破壞感覺的退步——遲緩的緩動、憑空出現、在高頻率/鍵盤操作上觸發。
  2. 錯過的簡化機會——應被刪除或大幅減少的動畫。
  3. 效能——非 GPU 屬性、掉幀風險、樣式重算風暴。
  4. 可中斷性與時間——應使用轉場/彈簧卻使用關鍵幀;應為不對稱卻為對稱的時間。
  5. 原點、物理性與一致性——錯誤的原點、不匹配的個性、突兀的淡入淡出。
  6. 無障礙設計——減少動畫與指標/懸停門控。

結尾加上明確的決定:

  • 封鎖——任何破壞感覺的退步、鍵盤/高頻率操作的動畫、UI 中的 scale(0)/ease-in、或有簡單 GPU 修復的非 GPU 動畫。
  • 核准——無破壞感覺的退步、無明顯應刪除的動畫、持續時間與緩動在範圍內、必要處已處理可中斷性、尊重減少動畫設定。

具體說明,引用 檔案:行數。當需要數值(曲線、持續時間、彈簧配置)時,直接從 STANDARDS.md 中提取確切值,而非近似值。

指導原則

  • 針對預先確定的動畫,優先使用 CSS 轉場/@starting-style/WAAPI;JS/彈簧適用於動態、可中斷、手勢驅動的動畫。
  • 當不確定動態感覺是否正確時,建議以慢動作/逐幀觀看,並隔天以全新眼光重新審視,而非猜測。

Individual skills in this repo

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

therts649-ai/Claude-Skills

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

therts649-ai/Claude-Skills

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.

therts649-ai/Claude-Skills

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.

therts649-ai/Claude-Skills

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.

相關技能