Figma Implement Motion 技能
Figma 出品的技能:把在 Figma 中制作的动画转成代码,React 用 motion.dev,其他网站用 CSS keyframes,时间和缓动分毫不差。
官方 · Figma| 作者 | Figma |
|---|---|
| 许可证 | No licence file; Figma Developer Terms apply |
| 来源 | figma/mcp-server-guide · GitHub 上的 SKILL.md |
| 项目官网 | developers.figma.com/docs/figma-mcp-server |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
figma-implement-motion 技能是 Figma 官方的智能体技能(Skill),用于把在 Figma 中设计的动画转成你项目中的代码。当某个框架使用了 Figma Motion 关键帧或动画样式时,智能体会用 Figma MCP 服务器的 get_motion_context 工具获取动效数据,用 get_design_context 获取布局,然后按节点 ID 把两者合并成可运行的 motion.dev(React)或 CSS keyframes 代码。
它的任务是保真:保留 Figma 中精确的时间、缓动曲线、弹簧效果和变换原点,只为 Figma 标明有动画的内容添加动画,并尊重访客的“减少动态效果”设置。它写的是代码,而不是 Figma 图层;如果要在 Figma 中创建或编辑动画,应使用 Figma 的 figma-use-motion 技能。Figma Motion 目前处于公开 beta 阶段,本技能很适合与负责设计静态部分的 figma-design-to-code 搭配使用。
摘自该技能的 SKILL.md: Translates Figma motion and animations into production-ready application code.
功能
- 用 get_design_context 获取框架的静态结构(或复用之前的调用结果),再用 get_motion_context 获取动效,并对每个有动画的图层递归获取。
- 把动效结果视为需要添加动画内容的完整清单,按节点 ID 把每个有动画的节点与设计代码对应起来,必要时把普通元素包装成 motion 元素。
- 原样使用 Figma 提供的现成代码片段(React 用 motion.dev,其他情况用 CSS @keyframes),而不是重新生成;并按结果应用文本分组的错开时间和共享时间轴(once、loop 或 boomerang)。
- 处理棘手情况:同一图层上既有静态旋转又有动画旋转、路径级 SVG 动画(内联 SVG 以便对真实路径做动画),以及会与动画变换冲突的布局变换。
- 适配你项目已在使用的动效库(Framer Motion、React Spring、GSAP、anime.js);对于 SwiftUI,会把缓动映射到真实的 SwiftUI API。
- 添加 prefers-reduced-motion 回退方案,先完整检查一个动画再处理其余动画,并用 TODO 注释标出无法导出的动效,而不是直接丢掉。
产出内容
- 你仓库中的动画代码:motion.dev 组件、CSS keyframes 或适配你所用动效库的代码,以及下载的资源。
- 不会改动 Figma 文件。
适用场景
- 设计师在 Figma 中为某个组件或界面做了动画,你需要在应用中实现同样的动效。
- get_design_context 提到了动效,或提示智能体调用 get_motion_context。
- 手工照抄的缓动和时长总是与设计对不上,你想要 Figma 中的精确数值。
不适用的场景
- 你想在 Figma 中创建或修改动画:那是 figma-use-motion 的工作。
- 设计中没有 Figma Motion 动画:静态界面请用 figma-design-to-code(该技能不会凭空添加动效)。
- 动画依赖组件变体过渡、动画蒙版或弧形路径:该技能自己的参考文档把这些列为目前还无法干净导出,并建议用视频或 Lottie 作为替代方案。
所需条件
- 已连接并登录的 Figma MCP 服务器(插件使用远程服务器;桌面版服务器上也有 get_motion_context)。
- 一个其框架使用了 Figma Motion 的 Figma 文件;Figma 称 Figma Motion 为面向所有套餐的公开 beta。该技能只读取文件,所以不需要 Full 席位,但读取调用有频率限制(Starter 套餐或 View、Collab 席位每月最多 20 次)。
- 你的代码库,以便它匹配你现有的动效库和组件。如果 React 项目还没有动效库,它会使用 motion.dev(motion 包)。
- 有动画的框架或图层的链接。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 各工具的作用、五步工作流程(结构、动效、合并、应用、验证)、交错变换,以及七条关键规则。 |
references/examples-and-anti-examples.md | 合并的完整示例和失败模式,例如重建 DOM 或丢失各元素的变换原点。 |
references/gotchas.md | Figma 特有的动效问题:嵌套组的轴心点、hold 缓动、自定义弹簧、颜色插值。 |
references/svg-and-path-motion.md | 对 SVG 路径本身做动画(描边显现、路径长度),而不是对它的外层容器。 |
references/framework-recommendations.md | 各技术栈的默认动效库、SwiftUI 缓动映射,以及彩纸、粒子、滚动联动动效等场景该优先选用哪个库。 |
references/unsupported-and-fallbacks.md | 目前还无法干净导出的内容,以及视频或 Lottie 替代方案。 |
references/motion-lint-rules.md | 智能体必须告知你的已知导出限制。 |
2026-11-15 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 用 motion.dev 在我们的 React 应用中实现这个 Figma 框架里的动画:<frame URL>。
- 把这个 Figma 组件中的加载动画加到 Spinner.tsx 里;我们已经在用 Framer Motion。
- 把 Figma 中这个带动画的首屏横幅转成使用 CSS keyframes 的纯 HTML,并遵循 prefers-reduced-motion。
- Figma 中的卡片翻转效果和我们的实现不一致。获取动效数据,修正 Card.tsx 中的缓动和时间。
如何安装 figma-implement-motion
连接 Figma MCP 服务器
在 Claude Code 中,安装 Anthropic 官方插件市场中的 Figma 插件,会添加远程 MCP 服务器,以及本技能和 Figma 的其他技能;然后运行 /mcp 并登录 Figma。只复制这个文件夹也可以:它不需要配套技能,不过 figma-design-to-code 很适合用来处理静态布局。
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp在 Cursor、Gemini CLI 和 VS Code 中
按照 Figma 的指南,在 Cursor(/add-plugin figma)和 Gemini CLI(作为扩展安装,然后运行 /mcp auth figma)中安装同一个插件,VS Code 则通过使用同一 URL 的 HTTP MCP 服务器连接。
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide不适用于 claude.ai 上传或 Claude API
该技能依赖 Figma MCP 服务器的动效和设计上下文工具。Claude API 的技能沙盒无法联网,我们也没有核实过 claude.ai 上的配置方法。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
- 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install figma@claude-plugins-official - 输入 / 查找
/figma:figma-implement-motion,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin install figma@claude-plugins-official插件会整体安装,因此会附带其他技能,包括 figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generate-library, figma-generative-plugins, figma-shaders, figma-spec, figma-swiftui, figma-use, figma-use-figjam, figma-use-motion, figma-use-slides。
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-implement-motion ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-implement-motion,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-implement-motion .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
两个工具,靠节点 ID 连接
get_design_context 说明每个图层长什么样、位于哪里;get_motion_context 说明哪些图层有动画、怎么动。该技能的核心做法是按节点 ID 把两者对应起来,并为复用组件内部的图层准备备用 ID,让每个动画都落在正确的元素上,同一组件的两个实例也能有不同的动效。
当两者在时间、缓动或数值上不一致时,以动效工具为准。
数值照搬,代码整理
时间、缓动、关键帧和变换原点都从 Figma 的代码片段中原样复制,因为重新生成会丢失自定义曲线和弹簧的回弹效果。但周围的代码不会盲目照抄:当许多图层共用同一个动画、只是延迟不同时,该技能会把它做成一个可复用的组件或 variants 对象,而不是为每个元素粘贴同一段代码。
关于 figma-implement-motion 的常见问题
figma-implement-motion 和 figma-use-motion 有什么不同?
两者分别作用在两端。figma-implement-motion 从 Figma 读取动画,并在你的应用中写成代码。figma-use-motion 则通过 use_figma 在 Figma 文件中创建或编辑动画。典型流程是先用 figma-use-motion 为设计添加动画,再用 figma-implement-motion 把它上线。
它输出哪些动画库的代码?
Figma 的 get_motion_context 返回 motion.dev 和 CSS @keyframes 代码片段。该技能默认在 React 中使用 motion.dev,在其他 Web 项目中使用 CSS,但会适配你项目已在使用的库,例如 Framer Motion、React Spring、GSAP 或 anime.js。SwiftUI 则由 CSS 片段转换而来。
它会处理“减少动态效果”吗?
会,默认就会。它的规则要求,它添加的任何动效在 prefers-reduced-motion 下都必须减弱或关闭,通常是直接呈现静止状态,或把时长缩短到几乎为零。
哪些内容还不能导出为代码?
该技能的参考文档列出了弧形路径、生成式效果、部分路径裁剪时间、组件变体过渡、动画蒙版,以及复杂的布尔运算或矢量网络动效。对于这些,它会建议视频或 Lottie 等替代方案,或者询问你。
figma-implement-motion 技能免费吗?
技能文件可以免费安装,但不是开源的:没有许可证文件,适用 Figma 的 Developer Terms。它需要一个 Figma 账号,并计入 Figma 读取类工具的调用频率限制;Figma Motion 本身处于公开 beta 阶段。
更多 AI 技能
相关技能
Figma Use Motion 技能
官方 · FigmaFigma 出品的技能:用 AI 为 Figma 文件中的图层添加动画,包括关键帧、动画样式、缓动、文字显现效果和时间轴长度。Figma Design to Code 技能
官方 · FigmaFigma 出品的技能:把 Figma 框架转成你项目中的代码,复用你的组件和资源,而不是粘贴生成的标记代码。Figma Generate Design 技能
官方 · FigmaFigma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。引用卡片与文字图形 技能
社区 · Frank Heijdenrijk选择一句有力原文并正确署名,规划易读文字卡片,不编造引文。