Figma Use Motion 技能
Figma 出品的技能:用 AI 为 Figma 文件中的图层添加动画,包括关键帧、动画样式、缓动、文字显现效果和时间轴长度。
官方 · 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-use-motion 技能是 Figma 官方的智能体技能(Skill),用于借助 Figma Motion 为 Figma 文件中的图层添加动画:添加和编辑关键帧、为填充和描边颜色做动画、应用动画样式、设置缓动和弹簧效果、制作打字机效果等文字显现动画,以及调整时间轴长度。它是 figma-use 的附加技能,总是与其一起加载。
它只负责时间维度;形状、组件和布局仍由 figma-use 处理。动效功能目前仍有门槛:Figma Motion 处于公开 beta 阶段,该技能提醒你的账号可能尚未开放这些 API,此时智能体会停下来告诉你。如果要把 Figma 动画作为代码上线,请改用配套的 figma-implement-motion 技能。
摘自该技能的 SKILL.md: Motion APIs might not be enabled for the calling user.
功能
- 先检查动效功能是否可用,一旦遇到第一个“not a supported API”错误就停止,而不是重试,因为动效、自定义动画样式和 3D 动效都可能分别对某个用户关闭。
- 使用 Figma 的公开字段名,在图层上添加、编辑或删除关键帧轨道(位置、旋转、缩放、不透明度、填充、描边和效果)。
- 在应用、编辑或删除动画样式之前,先找出 Figma 的内置动画样式和文件自己的自定义动画样式。
- 用 Figma 原生的文字错开(text stagger)按字符、单词、行或段落为文字做动画,文字保持可编辑,格式也不受影响。
- 用 Figma 公开的缓动类型(ease out、ease in and out、自定义三次贝塞尔、弹簧、hold)设置缓动,并以秒为单位延长时间轴;除非你要求,否则不会缩短。
- 通过导出顶层框架的低帧率小尺寸 MP4,并在本地用 ffmpeg 抽取画面来验证动效,因为截图只能显示静止状态。
产出内容
- Figma 文件中图层上的关键帧、动画样式和时间轴改动。
- 可选:Figma 导出的 MP4 预览,以及在你电脑上从中提取的静帧(仅当智能体验证动效且已安装 ffmpeg 时)。
适用场景
- 你想让智能体在 Figma 中为设计添加动画:按钮悬停、加载转圈、卡片入场、文字显现。
- 你需要在整个文件中应用或整理可复用的动画样式。
- Figma 原型中许多图层的时间和缓动需要一次性修正。
不适用的场景
- 你想在应用中以代码实现动画:请使用 figma-implement-motion。
- 静态设计工作(形状、组件、变量、布局):单独用 figma-use,界面则用 figma-generate-design。
- 你的 Figma 账号未开放动效功能:该技能无法绕过这一点,并会如实告诉你。
- 你需要从零编写一个全新的自定义预设模块:该技能说明这超出了它的范围。
所需条件
- 已连接并登录的远程 Figma MCP 服务器;只有远程服务器才能写入画布。
- 你的账号已开放 Figma Motion(公开 beta),并对文件有编辑权限。在草稿以外写入需要 Full 席位;Figma 表示写入画布在 beta 期间免费,之后将改为按用量计费的付费功能。
- 同时加载 Figma 的 figma-use 技能。如需 3D 倾斜、翻转或透视效果,还需要 figma-3d-transforms 技能和 Figma 的 3D API。
- 可选:在你的电脑上安装 ffmpeg,以便智能体从导出的视频中抽取画面来检查动效。导出在 Figma 的服务器上渲染,耗时从大约十秒到几分钟不等。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 运行时的功能开关、何时加载该技能、动效 API 范围、如何通过视频导出来验证,以及一份动效执行前检查清单。 |
references/motion-patterns.md | 关键帧轨道、可动画的字段、颜色和效果轨道、动画样式以及时间轴时长。 |
references/motion-custom-styles.md | 查找、创建、编辑、应用和删除文件自己的可复用动画样式。 |
references/text-animation.md | 用原生文字错开实现打字机效果和逐个显现的文字动画,文字保持可编辑。 |
references/motion-easing.md | 缓动对象、自定义三次曲线和弹簧曲线,以及 hold。 |
references/3d-transforms.md | 倾斜、翻转和透视动画,这些还需要 3D 权限。 |
2026-11-15 在仓库中查到的许可证:No licence file; Figma Developer Terms apply。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 在这个 Figma 文件中,让三张功能卡片依次淡入并上滑,间隔 150 ms,使用 ease-out 曲线:<frame URL>。
- 给 Hero 框架中的标题加上打字机式显现效果,逐词显示,总时长 1.2 秒。
- 把我们的“Pop in”自定义动画样式应用到 Onboarding 页面上的每个徽章。
- 让加载转圈持续旋转,并把时间轴延长到 2 秒;导出一段简短预览来检查效果。
如何安装 figma-use-motion
连接 Figma MCP 服务器,并同时安装 figma-use
在 Claude Code 中,安装 Anthropic 官方插件市场中的 Figma 插件,会添加远程 MCP 服务器和 Figma 的全部技能,包括本技能需要一起加载的 figma-use。然后运行 /mcp 并登录 Figma。如果手动复制文件夹,下面的命令也会复制 figma-use。
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确认你的账号能使用动效功能
在提出大型请求之前,先试一个小任务,例如让一个图层淡入。如果智能体报告某个动效属性“not a supported API”,说明你的账号还没有开放动效功能,技能中的任何设置都无法改变这一点。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
- 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install figma@claude-plugins-official - 输入 / 查找
/figma:figma-use-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-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, figma-use-figjam, 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-use-motion ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /figma-use-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-use-motion .agents/skills/
cp -R mcp-server-guide/skills/figma-use .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 对照各厂商的文档核实:
动效检查清单
该技能的执行前清单专门拦截动效脚本最常犯的错误:用了内部缓动名称而不是公开名称、ease-in-and-out 用了无效的别名、对顶层框架而不是其中的图层做动画、时间轴数值用了毫秒而不是秒,以及使用会报错的内部变换字段名。
文字动画总是在现有文字图层上使用原生文字错开,因此字符保持可编辑;其时长是整个错开过程的总时长,而不是每个字符的时长。
让每次视频导出都物有所值
由于导出很慢、要耗费实打实的渲染时间,该技能会先挑出需要检查的时间点(通常四到六帧,每个阶段一帧),以小尺寸、低帧率渲染,然后读取每一帧,把所有修正合并成一轮再重新渲染。
关于 figma-use-motion 的常见问题
figma-use-motion 和 figma-implement-motion 有什么不同?
figma-use-motion 在 Figma 文件中创建和编辑动画。figma-implement-motion 从 Figma 读取动画,并在你的项目中写成代码。前者用来设计动效,后者用来把它上线。
为什么智能体说不支持动效?
Figma Motion 处于公开 beta 阶段,该技能提醒其 API 可能并未对所有用户开放;自定义动画样式和 3D 动效也可能单独不可用。当调用失败并提示“is not a supported API”时,该技能要求智能体停下来告诉你,而不是重试。
智能体能看到它做的动画吗?
靠截图不行,截图只能显示静止状态。为了检查动效,它会通过 Figma 的 export_video 工具导出该框架的低帧率小尺寸 MP4,再用 ffmpeg 抽取几帧画面。导出在 Figma 的服务器上渲染,可能需要几分钟,所以该技能会规划每次渲染,明显的改动则直接跳过渲染。
它需要 figma-use 吗?
需要。figma-use 掌握每个 use_figma 脚本的 Plugin API 规则,figma-use-motion 再补充动效专用的规则;该技能要求两者一起加载。Figma 插件会同时安装两者。
figma-use-motion 技能免费吗?
这些文件可以免费安装,但不是开源的:没有许可证文件,适用 Figma 的 Developer Terms。你需要一个已开放 Figma Motion 的 Figma 账号,在草稿以外写入需要 Full 席位;Figma 表示 beta 结束后,写入画布将改为按用量计费的付费功能。
更多 AI 技能
相关技能
Figma Implement Motion 技能
官方 · FigmaFigma 出品的技能:把在 Figma 中制作的动画转成代码,React 用 motion.dev,其他网站用 CSS keyframes,时间和缓动分毫不差。Figma Use 技能(use_figma)
官方 · Figma每次写入 Figma 背后的基础技能:智能体通过 use_figma 在你的文件中运行 Plugin API 脚本时遵循的规则。Figma Generate Design 技能
官方 · FigmaFigma 出品的技能:根据你的代码,在 Figma 文件中搭建或更新界面,使用你设计系统中的组件和变量。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。引用卡片与文字图形 技能
社区 · Frank Heijdenrijk选择一句有力原文并正确署名,规划易读文字卡片,不编造引文。