Communitygithub.com

Asymmetric-al/core

审查 Core UI 或代码表面,发现少量合理的动效机会,并明确指出哪些应保持静态。当被问及哪些部分应该动、动效如何改善反馈或理解、如何让界面感觉更生动而不过度动画化,或某个提议的动效是否值得添加时使用。只读模式;请勿用于审查或修复现有动效代码,或实施动画。

core 是什么?

该技能旨在帮助开发者发现用户界面中高价值的动效机会,同时强调克制与精确。其核心理念是:为界面添加动效前,先确定哪些部分应保持静态,避免过度动画化带来的性能开销和用户体验问题。基于严格的五步候选检查机制(频率与输入、目的、用户价值、现有所有权、Core 可行性),该技能确保每次推荐的动效都有明确目的(如反馈、空间连续性或状态清晰度),并复用现有的运动令牌或预设。它支持在任何基于 Core 的 UI 上运行,审查范围包括组件、页面过渡、手势交互等。工作流程包括范围界定、扫描接缝、筛选候选、指定幸存者以及报告约束结果。输出结构化报告(动效机会表、拒绝候选表、总体裁决),并明确区分代码证据与现场感受检查。适合在构思阶段使用,而非用于修复现有动效或实施动画。

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

在你喜欢的 AI 中提问

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

文档

寻找动效机会

通过克制来发现高价值的动效。没有幸存机会的结果也是有效的;日常使用的产品 UI 通常受益于更少的动效。

触发条件

  • 当被问及哪些部分应该动、动效如何改善原本静态的界面、或哪些提议的动效想法值得追求时使用。
  • 请勿用于修复当前动画、审查动效差异或实施建议;将这些后续工作引导至现有的动效技能。

权限和边界

  1. 在评判表面之前,先阅读 docs/ai/rules/frontend.md,然后是 docs/ai/skills/emil-design-engineering/SKILL.md 和 docs/ai/skills/anim/SKILL.md。
  2. Core 的令牌、Base UI 原语、共享工具、路由转换边界、触摸门控和减少动效基线覆盖通用示例。
  3. 使用 improve-animations 审计或规划现有动效的修复,使用 review-animations 仅用于明确请求的动效差异审查。如果已批准的实现需要 motion/react 的详细信息,稍后使用 motion。
  4. 此技能仅报告证据和配方。活动期间不得编辑源代码、编写计划文件、安装工具或更改依赖项。

候选检查

每个建议必须通过全部五项检查:

  1. 频率和输入: 拒绝在键盘触发、高频或信息密集的交互上使用装饰性动效。频繁的反馈可能使用现有的近乎不可察觉的 Core 工具;它不是新的机会。
  2. 目的: 指定一个目的:反馈、空间连续性、状态清晰度、防止突变、解释或罕见的愉悦。“看起来很酷”不合格。
  3. 用户价值: 动效必须使因果、层次、进度或状态更容易理解。它不得延迟对内容或操作的访问。
  4. 现有所有权: 拒绝已经由 Button、Base UI 叠加层、共享悬停/按压工具或 RouteMainViewTransitionBoundary 提供的动效。切勿在其之上叠加第二个入场或悬停语法。
  5. Core 可行性: 配方必须使用现有的运动令牌/预设,避免使用布局驱动属性,保持可被中断(在状态可反转的情况下),保留减少动效行为,并将悬停动效限制为精细指针。

工作流程

  1. 侦察。 定义路由/组件范围、产品特性、输入方法、频率、当前动效拥有者以及性能/可访问性约束。在可用时检查运行中的 UI;否则说明仅凭代码证据的限制。
  2. 扫描接缝。 寻找突然的偶发状态变化、不清晰的空间关系、缺失的进度/反馈、罕见的空白/成功/入门时刻以及手势转换。同时检查最可能过度动画化的位置,以便报告包含有意义的拒绝。
  3. 筛选候选。 重新阅读每个引用的位置,应用所有五项检查。拒绝重复项、推测性想法以及已经有意设计的内容。
  4. 指定幸存者。 报告最多五个机会,按影响排序。指明要复用的现有 Core 令牌、预设、工具或原语。不要发明具体的持续时间、缓动函数、缩放或并行动画系统。
  5. 报告约束。 包含两到五个被拒绝的候选者以及拒绝它们的具体检查项。如果没有幸存者,说明界面应保持原样。

高价值接缝

  • 偶尔出现、消失或突然切换的内容或状态。
  • 一个面板或对象,其来源/目的地不明确,且尚未被 Base UI 原语或共享路由过渡层拥有。
  • 进度或完成反馈,其中动效可以阐明因果。
  • 罕见的一次运行、空白、成功或庆祝时刻,值得带来愉悦。
  • 需要连续性、可中断性或动量的手势驱动表面。

通常拒绝命令面板、键盘快捷键、密集表格、实时图表、常规列表导航、页面加载编排、全面滚动揭示以及用户正在阅读的数据上的装饰性移动。共享按钮已有按压反馈;共享叠加层和路由已有自己的动效语法。

必需的报告

动效机会

#位置当前接缝目的频率Core 兼容配方

每行需要精确的 file:line 证据和一个现有的 Core 机制。标记任何需要现场感受检查的内容,而不是假装代码能证明品味。

被拒绝的候选者

位置考虑的候选者拒绝项为何静态更好

裁决

说明表面实际需要多少动效,如果存在的话,最高影响力的幸存者是什么,以及是否需要后续的 improve-animations plan <description>。

检查清单

  • 检查的范围、频率、输入和当前动效拥有者清晰明确。
  • 每个幸存者都通过了目的、价值、所有权和可行性检查。
  • 建议复用了 Core 令牌/原语,没有重复动效。
  • 考虑了性能、触摸、键盘、减少动效和可中断性。
  • 报告中最多有五个机会,并包含明确的被拒绝候选者。
  • 发现引用了确切的文件/行,并区分代码证据和感受检查。
  • 检查期间未更改源代码、计划、依赖项或运行时文件。

来源

请参阅 references/upstream.md 以了解审阅的上游来源、MIT 许可证、Core 适配以及刷新工作流程。

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

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.

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.

相关技能