Communitygithub.com

therts649-ai/Claude-Skills

以 Emil Kowalski 的设计工程哲学为标准,审查动画和动效代码。默认提出警告,通过审查才可获批。

Claude-Skills 是什么?

这是一个专为审查动画和动效代码而设计的高标准 AI 技能。它基于 Emil Kowalski 的动画哲学(来自 animations.dev),以极苛刻的品质标准评估每一段动效。该技能遵循一套严密的审查流程,包括十条不可妥协的标准(如动效合理性、频率适配、响应式缓动、GPU 属性限制等)、攻击性升级触发条件、修复优先级层级以及严格的输出格式(发现表和最终判决)。它支持在 Claude Code、Cursor 等开发环境中使用,通过分析代码 diff 来识别感觉迟缓、来源错误、频率过高或性能低下的动效,并给出具体的修改建议,默认对任何可能破坏体验的动效提出阻止,而非轻易批准。

兼容平台✓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 动画 < 300ms。 UI 动画保持在 300ms 以内;任何更慢的 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 持续时间 > 300ms 且无说明理由
  • 基于触发器定位的弹出框/下拉菜单/工具提示中使用 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.95)+透明度替换 scale(0)。
  5. 使其可中断——关键帧转换为过渡,或为手势驱动动效使用弹簧。
  6. 移至 GPU——布局属性转换为 transform/opacity;简写转换为完整 transform 字符串;使用 WAAPI 进行程序化 CSS。
  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 动画。
  • 批准——无破坏感受的回归、无应删除的明显动效、持续时间和缓动在范围内、必要时已处理可中断性、尊重减少动效。

要具体,引用 file:line。当需要值时(曲线、持续时间、弹簧配置),从 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.

相关技能