Communitygithub.com

Asymmetric-al/core

檢查核心 UI 或程式碼表面,找出少量有理的動畫機會,並明確指出哪些部分應保持靜態。當被問到哪些元素應該有動畫、如何透過動畫改善回饋或理解、如何讓介面感覺更生動但不過度動畫化,或者某個提議的動畫是否值得添加時使用。僅供讀取;請勿用於審查或修正現有動畫程式碼,或實作動畫。

core 是什麼?

此技能旨在協助工程師與設計師,以審慎且有目標的方式,找出使用者介面中真正值得加入動畫的機會。它強調「剋制」,認為日常使用的產品 UI 通常需要更少的動畫,因此一個沒有動畫機會的結果也是有效的。此技能的核心原則是基於大量已建立的規則與門檻進行分析,包括檢查 `docs/ai/rules/frontend.md` 等文件,並嚴格審查每個候選項目是否通過頻率與輸入、目的、使用者價值、現有所有權和核心可行性等五道關卡。它會產生一份結構化的報告,包含最多五個優先級最高的動畫機會、被拒絕的候選項目及其原因,以及最終的裁定,說明該表面實際上需要多少動畫。此技能僅提供證據和配方,不會修改任何原始碼或設定檔。它支援的範圍包括從執行中的 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. 核心可行性: 配方必須使用現有的動畫令牌/預設集、避免佈局驅動屬性、在狀態可能反轉時保持可中斷性、保留減少動畫的行為,並將懸停動畫限制在精細指標裝置上。

工作流程

  1. 偵查。 定義路由/元件的範圍、產品特性、輸入方法、頻率、目前的動畫擁有者,以及效能/無障礙限制。如果可能,檢查執行中的 UI;否則說明僅程式碼證據的限制。
  2. 掃描縫隙。 尋找突然的、偶發的狀態變化、不明確的空間關係、遺失的進度/回饋、罕見的空/成功/入門時刻,以及手勢轉場。同時檢查最可能被過度動畫化的地方,以便報告中包含有意義的拒絕項目。
  3. 閘門候選項目。 重新閱讀每個引用的位置,並應用全部五項檢查。拒絕重複、投機性的點子,以及任何已經是刻意的東西。
  4. 指定倖存者。 報告最多五個機會,按影響力排序。指出要重複使用的現有 Core 令牌、預設集、工具程式或基本元件。不要發明具體的持續時間、緩動函數、比例或並行動畫系統。
  5. 報告剋制。 包含兩到五個被拒絕的候選項目,以及每個項目被拒絕的確切閘門。如果沒有任何東西倖存,請說明該介面應保持現狀。

高價值縫隙

  • 偶爾出現、消失或突然切換的內容或狀態。
  • 一個面板或物件,其來源/目的地不明確,且尚未由 Base UI 基本元件或共享的路由轉場層擁有。
  • 動畫能闡明因果關係的進度或完成回饋。
  • 罕見的首次執行、空狀態、成功或慶祝時刻,值得帶來愉悅感。
  • 需要連續性、可中斷性或動量的手勢驅動表面。

通常拒絕命令面板、鍵盤快捷鍵、密集的表格、即時圖表、常規列表導航、頁面載入編排、大範圍的捲動揭示,以及在使用者正在閱讀的資料上的裝飾性移動。共享的按鈕已經有按壓回饋;共享的覆蓋層和路由已經有自己的動畫語法。

必需的報告

機會

#位置當前縫隙目的頻率與核心相容的配方

每一行需要確切的 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.

相關技能