Communitygithub.com

Asymmetric-al/core

反向查找词汇表,将模糊的 Web 动画或动态效果描述转换为精确术语(比如“弹出框打开时的弹跳效果”→Pop in;“iOS 橡皮筋滚动”→Rubber-banding)。当用户询问“那个叫什么……”,或描述了一个动态效果但不知道其名称,并希望获得正确的术语以提示 AI 或设计师时使用。本技能用于命名效果,而非设计或构建。

core 是什么?

动画词汇(Animation Vocabulary)是一项 AI 代理技能,旨在解决开发者或设计师常见的问题:能描述一个动画效果,却不知道它的专业术语。该技能内置了一个经过筛选的词汇表,包含从“入场与退出”、“滚动交互”到“弹性动画”和“性能优化”等 11 个类别、超过 60 个术语。其工作原理是:用户用自然语言描述“感觉”(如“弹性的”、“滑出去的”),代理则根据高亮词汇表返回最匹配的术语,并在必要时提供近似选项的区分说明。它专门用于命名任务——不会将命名请求转化为 UI 实现或代码审查。它支持所有基于文本的 AI 代理平台(如 Claude Code, Cursor, Codex),并遵循异步工作流:先以 Glossary.css 为权威来源,若后续需要实现或审查,再加载 Core 的前端与动效规则。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animation-vocabulary

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

动画词汇

本仓库 (Asymmetric-al/core)

此仓库拥有的覆盖层保持上游词汇表范围狭窄且与 Core 的规范前端指南兼容。在上游刷新后,运行 bun run skills:sync 之前先将其与上游协调。

触发器

  • 用户描述了一个动态效果但不知道其名称。
  • 设计或实现讨论需要精确的动画词汇。
  • 不要将此技能用作实现或审查标准。
  • 对命名动态效果的具体请求应直接回答。上游的“初始响应”仅适用于没有明确问题或任务的纯调用。

工作流

  1. 使用上游词汇表命名并区分效果。
  2. 保持回答简洁,不要将命名请求变成 UI 工作。
  3. 如果随后需要进行实现或审查,加载 docs/ai/rules/frontend.md 和 docs/ai/skills/anim/SKILL.md;这些仓库的规则优先。

检查清单

  • 响应以最精确的词汇表术语开头。
  • 相近的替代项在未发明新词汇的情况下加以区分。
  • 任何实现建议都推迟到 Core 的前端和动效规则。

初始响应

当此技能首次被调用且没有特定问题时,仅回复:

我已准备好为你描述的任何一个动态效果命名,我的知识来自 Emil Kowalski 的动画哲学。

将模糊的运动或效果描述转化为精确术语,以便用户知道该如何要求。

快速开始

用户松散地描述一个效果。你按以下格式返回匹配的术语:

**Stagger** — 依次对多个元素进行动画,每个元素之间有小延迟,从而形成层叠效果。

如果多个术语都合适,先列出最佳匹配,然后是 1–2 个替代项,并附带一行说明它们之间的区别。

指令

  1. 解读意图,而非关键词。 用户描述他们看到或感受到的内容(“有弹性的”、“滑出去了”、“自己画出来”),而不是技术名称。将这种感觉映射到下面的词汇表。
  2. 逐字引用词汇表。 词汇表的描述是权威的——照搬使用,不要改写。
  3. 区分相近术语。 当两个术语竞争时(Clip-path 与 Mask,Pop in 与 Bounce,Shared element transition 与 Layout animation),对比它们以便用户选择。
  4. 当没有完全匹配时, 命名最接近的术语并明确说明这是近似值,或者用词汇表中的词汇描述该效果(例如“那是 stagger 的 scale-in 入场”)。
  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 — 内容逐渐被揭开,通常通过动画化 clip-path 或 mask。
  • 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 空间中旋转(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 — 将元素裁剪为某种形状,用于揭示、遮罩和前后对比滑块。
  • Mask — 使用形状或渐变隐藏或显示元素的一部分——类似于 clip-path,但具有柔和的、可淡化的边缘。
  • 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 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

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

Asymmetric-al/core

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

相关技能