Skip to content

Figma Use Motion skill

Figma's skill for animating layers inside a Figma file with AI: keyframes, animation styles, easing, text reveals and timeline length.

Official · Figma
AuthorFigma
LicenceNo licence file; Figma Developer Terms apply
Sourcefigma/mcp-server-guide · SKILL.md on GitHub
Project websitedevelopers.figma.com/docs/figma-mcp-server
Works inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Read from the source on

The figma-use-motion skill is Figma's official agent skill for animating layers inside a Figma file with Figma Motion: adding and editing keyframes, animating fill and stroke colours, applying animation styles, setting easing and springs, building text reveals such as a typewriter effect, and changing a timeline's length. It is an add-on to figma-use and always loads with it.

It handles only the time dimension; shapes, components and layout stay with figma-use. Motion is still gated: Figma Motion is an open beta and the skill warns that its APIs may not be enabled for your account, in which case the agent stops and tells you. To ship a Figma animation as code, use the companion figma-implement-motion skill instead.

From the skill's SKILL.md: Motion APIs might not be enabled for the calling user.

This is an official skill from Figma. Like any skill it gives the agent instructions and may include scripts it runs, so install it from the source linked here, not from a copy elsewhere.

What it does

  1. Checks that motion is available first and stops at the first "not a supported API" error rather than retrying, because motion, custom animation styles and 3D motion can each be switched off for a user.
  2. Adds, edits or removes keyframe tracks on layers (position, rotation, scale, opacity, fills, strokes and effects), using Figma's public field names.
  3. Discovers Figma's built-in animation styles and the file's own custom animation styles before applying, editing or removing them.
  4. Animates text by character, word, line or paragraph with Figma's native text stagger, keeping the text editable and its formatting intact.
  5. Sets easing with Figma's public easing shapes (ease out, ease in and out, custom cubic Bézier, springs, hold) and extends timelines in seconds without shortening them unless asked.
  6. Verifies motion by exporting a small, low-frame-rate MP4 of the top-level frame and sampling frames locally with ffmpeg, because a screenshot only shows the resting state.

What you get

  • Keyframes, animation styles and timeline changes on layers in your Figma file.
  • Optionally an MP4 preview from Figma's export and still frames extracted from it on your computer (only when the agent verifies the motion and ffmpeg is installed).

When to use it

  • You want an agent to animate a design in Figma: a button hover, a loading spinner, a card entrance, a text reveal.
  • You need to apply or tidy reusable animation styles across a file.
  • Timing and easing in a Figma prototype need fixing across many layers at once.

When not to use it

  • You want the animation as code in your app: use figma-implement-motion.
  • Static design work (shapes, components, variables, layout): figma-use alone, or figma-generate-design for screens.
  • Motion is not enabled for your Figma account: the skill cannot work around that and will tell you so.
  • You need a brand-new custom preset module written from scratch: the skill says that is out of scope.

What it needs

  • The remote Figma MCP server connected and signed in; writing to the canvas works only with the remote server.
  • Figma Motion enabled for your account (an open beta) and edit access to the file. Writing outside your drafts needs a Full seat; Figma says writing to the canvas is free during the beta and will later be usage-based and paid.
  • Figma's figma-use skill loaded with it. For 3D tilt, flips or perspective, the figma-3d-transforms skill and Figma's 3D APIs as well.
  • Optional: ffmpeg on your computer, so the agent can pull frames from a video export to check the motion. Exports render on Figma's servers and take from about ten seconds to minutes.

Files in the skill

File or folderWhat it is for
SKILL.mdRuntime gating, when to load the skill, the motion API surface, how to verify with a video export, and a motion pre-flight checklist.
references/motion-patterns.mdKeyframe tracks, animatable fields, colour and effect tracks, animation styles and timeline duration.
references/motion-custom-styles.mdFinding, creating, editing, applying and removing the file's own reusable animation styles.
references/text-animation.mdTypewriter and staggered text reveals with the native text stagger, keeping text editable.
references/motion-easing.mdEasing objects, custom cubic and spring curves, and hold.
references/3d-transforms.mdAnimated tilt, flips and perspective, which need 3D access as well.

Licence as found in the repository on 2026-11-15: No licence file; Figma Developer Terms apply.

Example prompts

Type one of these after installing; naming the skill makes sure it is used.

  • In this Figma file, make the three feature cards fade and slide up one after another, 150 ms apart, with an ease-out curve: <frame URL>.
  • Add a typewriter reveal to the headline in the Hero frame, word by word, over 1.2 seconds.
  • Apply our "Pop in" custom animation style to every badge on the Onboarding page.
  • Make the loading spinner rotate continuously and extend the timeline to 2 seconds; export a short preview to check it.

How to install figma-use-motion

Connect the Figma MCP server and install figma-use too

In Claude Code, Figma's plugin from Anthropic's official marketplace adds the remote MCP server and every Figma skill, including figma-use, which this skill loads alongside. Then run /mcp and sign in to Figma. If you copy folders by hand, the commands below copy figma-use as well.

claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp

Cursor, Gemini CLI and VS Code

Figma's guide installs the same plugin in Cursor (/add-plugin figma) and Gemini CLI (an extension, then /mcp auth figma), and connects VS Code through an HTTP MCP server with the same URL.

/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide

Check that motion works for your account

Before a big request, ask for something small, such as fading one layer in. If the agent reports that a motion property is not a supported API, motion is not enabled for you yet and no setting in the skill can change that.

A skill is a folder with a SKILL.md file. You install it once; the agent reads its short description at the start of each session and loads the full instructions only when a request matches. Pick the place you use:

Claude Code: from the plugin marketplace

  1. Start Claude Code in a terminal with claude.
  2. This plugin is in Anthropic's official marketplace, which Claude Code adds for you the first time you start it.
  3. Install the plugin. Claude Code opens its details first: check what it will add (skills, hooks, MCP servers), then choose whether it is for you, for everyone on this repository, or for you in this repository only.
    /plugin install figma@claude-plugins-official
  4. Type / and look for /figma:figma-use-motion, or simply ask for the task.

From your shell instead of a session:

claude plugin install figma@claude-plugins-official

The plugin installs as a whole, so other skills come with it, including 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: copy the folder into your skills folder

Put the skill's folder in ~/.claude/skills/ to use it in every project on this computer, or in .claude/skills/ inside a repository to share it with everyone who works there (commit it).

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 notices new or changed skills in these folders during the session. If the skills folder did not exist when the session started, run /reload-skills once. Then type /figma-use-motion or just describe the task.

On Windows, run the commands in Git Bash or WSL, or copy the folder into the same place with File Explorer.

Codex, Gemini CLI, Cursor and GitHub Copilot

These agents read the same SKILL.md folders. The one folder all four accept inside a project is .agents/skills/, so this copies the skill there:

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/
AgentProject folderYour user folderNotes
OpenAI Codex
.agents/skills/
~/.agents/skills/
Type $ or run /skills to pick a skill; Codex also chooses one when your task matches.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Or install from Git with gemini skills install <git URL> --path <folder> --consent. Google replaced Gemini CLI with Antigravity CLI for free-tier and Google One users on 18 June 2026; Antigravity uses .agents/skills/ in a project and ~/.gemini/config/skills/ for you.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Type / in Agent chat to pick a skill. Cursor also reads Claude Code's .claude/skills/ folders.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Works in Copilot CLI, the cloud agent, and agent mode in VS Code, Visual Studio and JetBrains (IDE support depends on the version). Or run gh skill install OWNER/REPOSITORY SKILL (public preview, GitHub CLI 2.90.0 or later).
Only install skills you trust. Anthropic's advice is to use skills only from trusted sources, and to read every file of any other skill before using it: a skill can direct the agent to run commands, read files or send data in ways its description does not mention.

Sources for these steps

Checked against each vendor's documentation on 2026-11-14:

The motion checklist

The skill's pre-flight list catches the errors that motion scripts make most: internal easing names instead of the public ones, the invalid alias for ease-in-and-out, animating a top-level frame instead of the layers inside it, timeline values in milliseconds instead of seconds, and internal transform field names that throw.

Text animation always uses the native text stagger on the existing text layer, so the characters stay editable, and its duration is the total stagger span rather than per character.

Making each video export count

Because exports are slow and cost real rendering time, the skill picks the moments to check first (usually four to six frames, one per phase), renders small and at a low frame rate, then reads every frame and batches all fixes into one pass before rendering again.

Questions about figma-use-motion

How is figma-use-motion different from figma-implement-motion?

figma-use-motion creates and edits animation inside the Figma file. figma-implement-motion reads an animation from Figma and writes it as code in your project. Use the first to design the motion and the second to ship it.

Why does the agent say motion is not supported?

Figma Motion is an open beta, and the skill warns that its APIs might not be enabled for every user; custom animation styles and 3D motion can be unavailable separately. When a call fails with "is not a supported API", the skill tells the agent to stop and tell you instead of retrying.

Can the agent see the animation it made?

Not from a screenshot, which only shows the resting state. To check motion it exports a small, low-frame-rate MP4 of the frame through Figma's export_video tool and pulls a handful of frames with ffmpeg. The export renders on Figma's servers and can take minutes, so the skill plans each render and skips it for obvious changes.

Does it need figma-use?

Yes. figma-use holds the Plugin API rules for every use_figma script, and figma-use-motion adds the motion-specific ones; the skill says to load both together. Figma's plugin installs both.

Is the figma-use-motion skill free?

The files are free to install but not open source: there is no licence file and Figma's Developer Terms apply. You need a Figma account with Figma Motion available, a Full seat to write outside your drafts, and Figma says writing to the canvas will become usage-based and paid after the beta.

More AI skills

Related skills

Skill categories