Communitygithub.com

CharbelElBateh/personal-website

反向查詢詞彙表:將模糊的網頁動畫或動態效果描述轉換為精確術語(例如,「彈出視窗打開時的彈跳感」→ Pop in;「iOS 的橡皮筋滾動」→ Rubber-banding)。當使用者詢問「這個叫什麼來著…」或描述一個動態效果卻不知道其名稱,並希望獲得正確詞彙以提示 AI 或設計師時使用。適用於命名效果,而非設計或實作效果。

personal-website 是什麼?

這是一個專門的動畫詞彙反查工具,旨在將使用者對網頁動畫或動態效果的模糊描述(如「那個彈跳的感覺」、「那個像滑出去的效果」)轉換為精確的專業術語。它支援任何需要命名動畫效果的 AI 平台或設計協作場景,例如 Claude Code、Cursor、Codex 等。其核心是一個結構化的詞彙庫,涵蓋了從進場與退場、序列與時序、移動與變形、狀態轉換、滾動、反饋與互動、緩動函數、彈簧動畫、循環與環境動畫、打磨與特效到效能與原則等完整分類。使用時,AI 會根據使用者描述的「感覺」或「視覺體驗」來匹配最合適的術語,並在必要時提供相近選項進行區分,以幫助使用者準確地向 AI 或設計師描述所需效果。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animation-vocabulary

在你喜歡的 AI 中提問

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

說明文件

動畫詞彙

初始回應

當此技能首次被調用且沒有特定問題時,僅回覆:

我已準備好為您描述的任何動態效果命名,我的知識源自 Emil Kowalski 的動畫哲學。

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

將對動作或效果的模糊描述轉換為精確術語,以便使用者知道該如何提問。

快速開始

使用者鬆散地描述一個效果。您以下列格式回傳匹配的術語:

**Stagger(錯開)** — 將多個項目一個接一個地動畫化,每個之間有短暫延遲,形成串聯效果。

如果有多個術語可能符合,請先列出最匹配的,然後列出 1-2 個替代方案,並附上一行說明其差異。

指示

  1. 閱讀意圖,而非關鍵字。 使用者描述的是他們 看到 或 感受到 的東西(「有彈性的」、「滑出去」、「自己畫出來」),而非技術名稱。將感覺映射到下面的詞彙庫。
  2. 逐字引用詞彙庫。 其中的描述是權威性的 — 請按原樣使用,不要改寫。
  3. 區分相近術語。 當兩個術語相近時(Clip-path(剪裁路徑) vs Mask(遮罩)、Pop in(彈入) vs Bounce(彈跳)、Shared element transition(共享元素轉場) vs Layout animation(版面動畫)),對比它們以便使用者選擇。
  4. 當沒有完全匹配時, 命名最接近的術語,並明確說明這只是近似,或者使用詞彙庫的詞彙來描述該效果(例如,「這是 錯開 的 縮放進入 入口」)。
  5. 僅限於此詞彙庫。 如果一個術語確實不在這裡,請直接說明,而不是自行發明 — 儘管您可以使用這些詞彙來解釋概念。
  6. 保持簡潔。 命名問題想要一個名稱,而不是一篇論文。先給出術語;只有當被問到時才擴展說明。

範例

範例 1 — 基於感覺 使用者:「當彈出視窗似乎是從你點擊的按鈕中長出來的,而不是從其中間長出來的,這叫什麼?」 輸出:

**Origin-aware animation(起點感知動畫)** — 元素從其觸發點動畫化出來,例如彈出視窗從打開它的按鈕中長出來,而不是從其自身的中心(這是 CSS 的預設行為)。

範例 2 — 區分 使用者:「一個圖片變成另一個圖片的東西。」 輸出:

**Morph(變形)** — 一個形狀平滑地變成另一個形狀,例如動態島。

相近替代方案:
- **Crossfade(交叉淡變)** — 如果它們只是在同一個位置互相淡出淡入。
- **Shared element transition(共享元素轉場)** — 如果一個元素從一個位置移動並轉換到另一個位置。

範例 3 — 物理感覺 使用者:「那個 iOS 的滾動,當你拉得太遠時它會抵抗並彈回來。」 輸出:

**Rubber-banding(橡皮筋效應)** — 當你拖曳超過邊界時產生的阻力和回彈(iOS 的過度滾動感覺)。

詞彙庫

反映專案 /vocabulary 頁面的精選快照;當任一變更時,保持兩者同步。

進場與退場 — 元素如何出現和消失

  • Fade in / Fade out(淡入 / 淡出) — 元素透過改變透明度來出現或消失。
  • Slide in(滑入) — 元素從螢幕外(左、右、上方或下方)滑入。
  • Scale in(縮放進入) — 元素在出現時從較小尺寸成長到完整尺寸,通常會搭配淡出效果。
  • Pop in(彈入) — 元素出現時帶有輕微的超調,就像彈跳到位一樣。
  • Reveal(揭示) — 內容逐漸被揭露,通常是透過動畫化剪裁路徑或遮罩。
  • Enter / Exit(進入 / 退出) — 元素被加入或從螢幕移除時播放的動畫。

序列與時序 — 協調多個元素或時刻

  • Keyframes(關鍵影格) — 動畫中定義的點(0%、50%、100%),瀏覽器會填補之間的空隙。
  • Interpolation / Tween(插值 / 補間) — 在開始值和結束值之間產生所有中間影格,使動作連續。
  • Stagger(錯開) — 將多個項目一個接一個地動畫化,每個之間有短暫延遲,形成串聯效果。
  • Orchestration(編排) — 刻意安排多個動畫的時間,使其感覺像一個協調的動作。
  • Delay(延遲) — 動畫開始前的時間。
  • Duration(持續時間) — 動畫花費的時間長度。
  • Fill mode(填充模式) — 元素在動畫開始前或結束後是否保留其第一個或最後一個影格的樣式(例如 forwards)。
  • Stepped animation(階梯式動畫) — 分為離散步驟的動畫,例如倒數計時器。

移動與變形 — 改變元素的位置、大小或角度

  • Translate(平移) — 沿 X 或 Y 軸移動元素。
  • Scale(縮放) — 使元素變大或變小。
  • Rotate(旋轉) — 繞著一個點旋轉元素。
  • Skew(傾斜) — 沿 X 或 Y 軸傾斜元素,使其偏離矩形形狀。
  • 3D tilt / Flip(3D 傾斜 / 翻轉) — 在 3D 空間中旋轉(rotateX / rotateY)以增加深度感。
  • Perspective(透視) — 3D 效果看起來的強度 — 較低的值會誇大深度,就像觀看者更近。
  • Transform origin(變形原點) — 縮放或旋轉所圍繞的錨點。
  • Origin-aware animation(起點感知動畫) — 元素從其觸發點動畫化出來,例如彈出視窗從打開它的按鈕中長出來,而不是從其自身的中心(這是 CSS 的預設行為)。

狀態之間的轉場 — 連接一個狀態、視圖或元素到另一個

  • Crossfade(交叉淡變) — 一個元素淡出的同時另一個元素在同一個位置淡入。
  • Continuity transition(連續性轉場) — 透過在視覺上連接前後狀態來讓使用者保持方向感的變更。例如,將同一個矩形變大然後變小。
  • Morph(變形) — 一個形狀平滑地變成另一個形狀,例如動態島。
  • Shared element transition(共享元素轉場) — 一個元素從一個位置移動並轉換到另一個位置,例如縮圖展開成一張卡片。
  • Layout animation(版面動畫) — 當元素的大小或位置改變時,它會動畫化到新位置,而不是直接跳轉。
  • Accordion / Collapse(手風琴 / 折疊) — 一個區塊平滑地展開和折疊其高度以顯示或隱藏內容。
  • Direction-aware transition(方向感知轉場) — 內容前進時向一個方向滑動,返回時向相反方向滑動,使導航具有方向感。

滾動 — 與滾動或導覽視圖相關的動作

  • Scroll reveal(滾動揭示) — 元素在進入視口時淡入或滑入到位。
  • Scroll-driven animation(滾動驅動動畫) — 動畫的進度直接與滾動位置相關聯。
  • Parallax(視差) — 滾動時背景和前景以不同速度移動,創造深度感。
  • Page transition(頁面轉場) — 從一個頁面或路由導覽到另一個時播放的動畫。
  • View transition(視圖轉場) — 瀏覽器在兩個狀態或頁面之間變形,連接共享元素。

回饋與互動 — 回應使用者的操作

  • Hover effect(懸停效果) — 當游標移到元素上時的視覺變化。
  • Press / Tap feedback(按下 / 點擊回饋) — 元素被點擊時微妙的縮小效果,使其感覺有實體感。
  • Hold to confirm(長按確認) — 在使用者按住按鈕時填充的進度效果。
  • Drag(拖曳) — 透過抓取來移動元素,釋放時通常帶有動量。
  • Drag to reorder(拖曳排序) — 拖曳列表中的項目以重新排列,同時其他項目會移動來騰出空間。
  • Swipe to dismiss(滑動關閉) — 將元素拖曳到螢幕外以關閉它,例如抽屜或提示訊息。
  • Rubber-banding(橡皮筋效應) — 當你拖曳超過邊界時產生的阻力和回彈(iOS 的過度滾動感覺)。
  • Shake / Wiggle(搖晃 / 抖動) — 快速左右抖動,表示錯誤或輸入被拒絕。
  • Ripple(漣漪) — 從點擊點擴展出的圓圈,確認點擊。

緩動函數 — 速度在動畫過程中如何變化

  • Easing(緩動) — 動畫加速或減速的速率。
  • Ease-out(減速結束) — 開始快,結束慢。大多數 UI 和響應使用者操作的動畫的預設值。
  • Ease-in(加速開始) — 開始慢,結束快。通常應避免;可能感覺遲緩。
  • Ease-in-out(加減速) — 慢、快、慢。適合螢幕上從 A 點移動到 B 點的元素。
  • Linear(線性) — 恆定速度。避免用於 UI;保留給旋轉器或跑馬燈。
  • Cubic-bezier(三次貝茲曲線) — 您定義的自訂緩動曲線,以實現精確控制。
  • Asymmetric easing(非對稱緩動) — 加速和減速速率不同的曲線。感覺比對稱曲線更有活力。

彈簧動畫 — 基於物理的運動,作為固定持續時間緩動的替代方案

  • Spring(彈簧) — 由物理(張力、質量、阻尼)驅動的運動,而非設定的持續時間。
  • Stiffness / Tension(剛度 / 張力) — 彈簧拉向其目標的力道。較高的值感覺更乾脆。
  • Damping(阻尼) — 彈簧穩定下來的速度。較低的阻尼意味著更多的彈跳和振盪。
  • Mass(質量) — 動畫元素感覺起來的重量。質量越大,動作越慢且越遲鈍。
  • Bounce(彈跳) — 一個會超調然後穩定下來的彈簧,增添俏皮感。
  • Perceptual duration(感知持續時間) — 彈簧感覺完成所需的時間,即使它在底層仍在微調。
  • Momentum(動量) — 帶有速度的運動,特別是在拖曳或中斷之後。
  • Velocity(速度) — 元素移動的快慢和方向。彈簧會將其帶入中斷時的下一個動畫,因此快速撥動的元素會保持其速度。
  • Interruptible animation(可中斷動畫) — 可以在進行中平滑地重新導向的動畫,而不是必須先完成。

循環與環境動畫 — 自行運行的動畫

  • Marquee(跑馬燈) — 文字或內容在循環中持續滾動。
  • Loop(循環) — 重複播放的動畫,可以是特定次數或無限。
  • Alternate (yoyo)(交替 / 迴力鏢) — 一種循環,每次迭代先正向播放然後反向播放,而不是跳回起點。
  • Orbit(環繞) — 一個元素在連續路徑上繞著另一個元素轉圈。
  • Pulse(脈衝) — 溫和的重複縮放或透明度變化,以吸引注意力。
  • Float(漂浮) — 溫和、持續的上下漂移,使靜態元素感覺有生命力且失重。
  • Idle animation(閒置動畫) — 元素待在那裡等待被互動時播放的微妙動作。

打磨與特效 — 區分好與偉大之間的小細節

  • Blur(模糊) — 用於柔化元素或遮蓋微小瑕疵的模糊濾鏡。
  • Clip-path(剪裁路徑) — 將元素裁剪成一個形狀,用於揭示、遮罩和 Before/After 滑桿。
  • Mask(遮罩) — 使用形狀或漸層隱藏或顯示元素的部分區域 — 類似於剪裁路徑,但具有柔軟、可淡化的邊緣。
  • Before / after slider(前後比較滑桿) — 一個可拖曳的分隔線,在兩張重疊的圖片之間擦拭以進行比較。
  • Line drawing(線條繪製) — SVG 路徑自己畫出來,就像一支看不見的筆在描繪它。
  • Text morph(文字變形) — 文字在變化時逐字元動畫化,將注意力吸引到新數值上。
  • Skeleton / Shimmer(骨架 / 微光) — 內容加載時顯示的、帶有移動光澤的佔位符。
  • Number ticker(數字計數器) — 數字滾動或計數到一個值。
  • Tabular numbers(等寬數字) — 固定寬度的數字,使數字在變化時不會移動位置。對於計數器、計時器和計數器至關重要。
  • Typewriter(打字機) — 文字一次出現一個字元,就像在打字一樣。

效能 — 保持動作流暢而不是卡頓的關鍵

  • Frame rate (FPS)(影格率) — 每秒繪製的影格數。60fps 是流暢運動的基準;120fps 用於較新的顯示器。
  • Jank(卡頓) — 當瀏覽器因無法跟上動畫而掉影格時出現的可見停頓。
  • Dropped frame(掉影格) — 瀏覽器錯過了繪製截止時間的影格,導致動作中出現細微的卡頓。
  • Compositing(合成) — 讓 GPU 在其自己的圖層上移動或淡化元素,而無需重新進行佈局或繪製。
  • will-change(即將變更) — 一個 CSS 提示,告訴瀏覽器某個元素即將開始動畫,以便它可以提前將其提升到自己的圖層。
  • Layout thrashing(佈局抖動) — 對像 width、height、top 或 left 之類的屬性進行動畫化,迫使瀏覽器在每個影格重新計算佈局,導致卡頓。

需知原則 — 指導何時以及如何動畫化的概念

  • Purposeful animation(有目的的動畫) — 動作應該服務於一個功能 — 提供方向、給予回饋、顯示關係 — 而不僅僅是裝飾。
  • Anticipation(預備動作) — 在移動之前朝相反方向進行小幅度的蓄力,暗示即將發生的事情。
  • Follow-through(跟隨動作) — 元素的一部分在主動作停止後繼續移動並稍微穩定下來,增加重量感。
  • Squash & stretch(擠壓與拉伸) — 元素在移動時變形,以傳達重量、速度和靈活性。
  • Perceived performance(感知效能) — 正確的動畫讓介面感覺更快,即使實際上並非如此。
  • Frequency of use(使用頻率) — 使用者看到動畫的頻率越高,它就應該越短、越不明顯。
  • Spatial consistency(空間一致性) — 動畫化時,元素在各狀態間保持其身份和位置,使用者永遠不會迷失方向。
  • Hardware acceleration(硬體加速) — 對 transform 和 opacity 進行動畫化可以讓 GPU 保持動作流暢。
  • Reduced motion(減少動畫) — 尊重使用者的 prefers-reduced-motion 設定,減少或移除動作。

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

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

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

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.

相關技能