Communitygithub.com

deuriib/agent-skills

触发:animate-ui、motion 组件、动画 shadcn。实现并自定义源自 Animate UI 的 Motion 驱动组件。

agent-skills 是什么?

这个技能旨在帮助开发者在使用 Animate UI 分发库时,添加或自定义动画 UI 组件。它专门针对已将 shadcn/ui 集成到项目中的场景,指导如何利用 Motion(Framer Motion)来构建动态界面。技能的核心遵循“复制优先”方法,将组件视为可修改的开放代码,而非固定库导入,从而提供更大的灵活性。它支持通过 shadcn CLI 添加基本原语和完整样式组件,并确保正确安装 `motion`、`tailwind-merge`、`clsx` 和 `lucide-react` 等依赖。无论是搭建新项目还是扩展现有项目,该技能都能系统地引导开发者完成验证、选择、安装和集成组件的全过程,并针对特定的 spring 动画参数进行调整,以匹配项目的整体风格。

兼容平台~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使用 motion 属性(例如 whileHover、transition)扩展现有组件。

执行步骤

  1. 验证先决条件:检查 package.json 中是否包含 framer-motion(或 motion)和 tailwind-merge。
  2. 初始设置:如果尚未完成,请遵循 shadcn/ui 的初始化过程。
  3. 组件选择:确定是需要一个原语(逻辑 + 基础动画)还是一个组件(带样式的 UI 部件)。
  4. 安装:使用 shadcn CLI 并指定 @animate-ui 作用域包名。
  5. 集成:从 @/components/animate-ui/... 导入并传递必要的属性。
  6. 打磨:调整 spring 过渡(刚度、阻尼)以匹配项目的整体感觉。

输出契约

  • 通过 shadcn CLI 添加的组件列表。
  • 已验证的实现中的导入路径。
  • 如有任何自定义运动调整,需提供相应解释。

参考

  • references/getting-started.md — 安装和设置指南。
  • references/components.md — 类别和命名约定。
  • references/motion-patterns.md — 常见的 spring 和过渡设置。

相关技能