Communitygithub.com

deuriib/agent-skills

觸發條件:animate-ui、motion 組件、動畫化的 shadcn。實作並自訂由 Animate UI 提供的 Motion 驅動組件。

agent-skills 是什麼?

這個技能讓 AI 代理能夠在 shadcn/ui 專案中,使用 Animate UI 發行版來新增或自訂動畫 UI 組件。它主要透過 Motion(原 Framer Motion)來驅動動畫,並遵循「複製優先」的開放程式碼模式,讓開發者可以自由修改組件,而不是當作固定的函式庫匯入。支援的平台包括 React、Tailwind CSS 和 Motion,並可透過 shadcn CLI 安裝原始組件(Primitives)或完整樣式組件(Components)。此技能會自動檢查相依套件(如 motion、tailwind-merge、clsx、lucide-react),並遵循特定的命名慣例(如 @animate-ui/{類別}-{子類別}-{名稱})與匯入路徑(預設為 @/components/animate-ui/)。此外,它還能指導使用者調整彈簧過渡效果(如 stiffness、damping),以符合專案的視覺感受。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deuriib/agent-skills/tree/HEAD/skills/animate-ui

在你喜歡的 AI 中提問

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

說明文件

技能:animate-ui

啟動合約

請在以下情況使用此技能:

  • 使用 Animate UI 發行版新增或自訂動畫 UI 組件。
  • 在 shadcn/ui 專案中實作 Motion 驅動(Framer Motion)的設計模式。
  • 設定 Animate UI 註冊表,或新增特定的原始組件/組件。

嚴格規則

  • 複製優先方法:始終將組件視為「開放程式碼」,可複製並修改,而非固定的函式庫匯入。
  • 相依性檢查:在新增組件前,確保已安裝 motion、tailwind-merge、clsx 和 lucide-react。
  • 命名慣例:對於 shadcn CLI 指令,請遵循 @animate-ui/{類別}-{子類別}-{名稱} 的模式。
  • 匯入路徑:所有新增的組件和原始組件,預設匯入路徑為 @/components/animate-ui/。
  • 標準技術棧:使用 React、Tailwind CSS 和 Framer Motion(Motion)。

決策閘門

任務動作
新專案執行 npx shadcn@latest init,然後設定 Tailwind/Motion。
新增原始組件使用 npx shadcn@latest add @animate-ui/primitives-{類別}-{名稱}。
新增組件使用 npx shadcn@latest add @animate-ui/components-{類別}-{名稱}。
自訂動畫使用 motion 的 props(例如 whileHover、transition)擴展現有組件。

執行步驟

  1. 驗證先決條件:檢查 package.json 中是否包含 framer-motion(或 motion)和 tailwind-merge。
  2. 初始設定:如果尚未完成,請遵循 shadcn/ui 的初始化流程。
  3. 選擇組件:判斷需要的是原始組件(邏輯 + 基礎動畫)還是組件(已樣式化的 UI 元件)。
  4. 安裝:使用 shadcn CLI,搭配 @animate-ui 範圍套件名稱。
  5. 整合:從 @/components/animate-ui/... 匯入,並傳遞必要的 props。
  6. 打磨:調整彈簧過渡效果(stiffness、damping)以符合專案的整體感覺。

輸出合約

  • 透過 shadcn CLI 新增的組件清單。
  • 在實作中驗證過的匯入路徑。
  • 如有任何自訂動畫調整的說明。

參考資料

  • references/getting-started.md — 安裝與設定指南。
  • references/components.md — 類別與命名慣例。
  • references/motion-patterns.md — 常見的彈簧與過渡設定。

相關技能