Skill Figma Use Motion
A skill da Figma para animar camadas dentro de um arquivo do Figma com IA: keyframes, estilos de animação, easing, revelação de texto e duração da timeline.
Oficial · Figma| Autor | Figma |
|---|---|
| Licença | No licence file; Figma Developer Terms apply |
| Fonte | figma/mcp-server-guide · SKILL.md no GitHub |
| Site do projeto | developers.figma.com/docs/figma-mcp-server |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
A skill figma-use-motion é a skill oficial da Figma para agentes animarem camadas dentro de um arquivo do Figma com o Figma Motion: adicionar e editar keyframes, animar cores de preenchimento e de traço, aplicar estilos de animação, definir easing e molas, criar revelações de texto como um efeito máquina de escrever e mudar a duração de uma timeline. Ela é um complemento da figma-use e sempre é carregada junto com ela.
Ela cuida só da dimensão do tempo; formas, componentes e layout ficam com a figma-use. A animação ainda tem acesso restrito: o Figma Motion está em beta aberto, e a skill avisa que as APIs dele podem não estar ativadas na sua conta; nesse caso, o agente para e avisa você. Para levar uma animação do Figma para o código, use a skill complementar figma-implement-motion.
Do SKILL.md da skill: Motion APIs might not be enabled for the calling user.
O que ela faz
- Confere primeiro se a animação está disponível e para no primeiro erro “not a supported API” em vez de tentar de novo, porque a animação, os estilos de animação personalizados e a animação 3D podem estar desativados separadamente para um usuário.
- Adiciona, edita ou remove trilhas de keyframes nas camadas (posição, rotação, escala, opacidade, preenchimentos, traços e efeitos), usando os nomes de campo públicos do Figma.
- Descobre os estilos de animação nativos do Figma e os estilos de animação personalizados do próprio arquivo antes de aplicá-los, editá-los ou removê-los.
- Anima texto por caractere, palavra, linha ou parágrafo com o stagger de texto nativo do Figma, mantendo o texto editável e a formatação intacta.
- Define o easing com as formas públicas do Figma (ease out, ease in and out, cubic Bézier personalizada, molas, hold) e estende timelines em segundos, sem encurtá-las a menos que você peça.
- Verifica a animação exportando um MP4 pequeno, com taxa de quadros baixa, do frame de nível superior e extraindo quadros localmente com ffmpeg, porque uma captura de tela só mostra o estado de repouso.
O que você recebe
- Keyframes, estilos de animação e mudanças de timeline nas camadas do seu arquivo do Figma.
- Opcionalmente, uma prévia em MP4 exportada pelo Figma e quadros extraídos dela no seu computador (só quando o agente verifica a animação e o ffmpeg está instalado).
Quando usar
- Você quer que um agente anime um design no Figma: o hover de um botão, um spinner de carregamento, a entrada de um card, uma revelação de texto.
- Você precisa aplicar ou organizar estilos de animação reutilizáveis em um arquivo.
- O timing e o easing de um protótipo do Figma precisam ser corrigidos em muitas camadas de uma vez.
Quando não usar
- Você quer a animação como código no seu app: use a figma-implement-motion.
- Trabalho de design estático (formas, componentes, variáveis, layout): só a figma-use, ou a figma-generate-design para telas.
- A animação não está ativada na sua conta do Figma: a skill não tem como contornar isso e vai avisar você.
- Você precisa de um módulo de preset personalizado totalmente novo escrito do zero: a skill diz que isso está fora do escopo.
O que ela exige
- O servidor MCP remoto do Figma conectado e com login feito; gravar no canvas só funciona com o servidor remoto.
- O Figma Motion ativado na sua conta (um beta aberto) e acesso de edição ao arquivo. Gravar fora dos seus rascunhos exige um assento Full; a Figma diz que gravar no canvas é grátis durante o beta e depois será pago, cobrado por uso.
- A skill figma-use da Figma carregada junto. Para inclinação 3D, flips ou perspectiva, também a skill figma-3d-transforms e as APIs 3D do Figma.
- Opcional: ffmpeg no seu computador, para que o agente extraia quadros de um vídeo exportado e confira a animação. As exportações são renderizadas nos servidores da Figma e levam de cerca de dez segundos a alguns minutos.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | Controle de acesso em tempo de execução, quando carregar a skill, as APIs de animação disponíveis, como verificar com um vídeo exportado e uma checklist prévia de animação. |
references/motion-patterns.md | Trilhas de keyframes, campos animáveis, trilhas de cor e de efeito, estilos de animação e duração da timeline. |
references/motion-custom-styles.md | Como encontrar, criar, editar, aplicar e remover os estilos de animação reutilizáveis do próprio arquivo. |
references/text-animation.md | Revelações de texto tipo máquina de escrever e escalonadas com o stagger de texto nativo, mantendo o texto editável. |
references/motion-easing.md | Objetos de easing, curvas cubic e spring personalizadas, e hold. |
references/3d-transforms.md | Inclinação, flips e perspectiva animados, que também exigem acesso a 3D. |
Licença conforme encontrada no repositório em 2026-11-15: No licence file; Figma Developer Terms apply.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- Neste arquivo do Figma, faça os três cards de recursos aparecerem com fade e deslizarem para cima um depois do outro, com 150 ms de intervalo e uma curva ease-out: <frame URL>.
- Adicione uma revelação tipo máquina de escrever ao título do frame Hero, palavra por palavra, em 1,2 segundo.
- Aplique o nosso estilo de animação personalizado “Pop in” a todos os badges da página Onboarding.
- Faça o spinner de carregamento girar sem parar e estenda a timeline para 2 segundos; exporte uma prévia curta para conferir.
Como instalar a skill figma-use-motion
Conecte o servidor MCP do Figma e instale também a figma-use
No Claude Code, o plugin da Figma no marketplace oficial da Anthropic adiciona o servidor MCP remoto e todas as skills da Figma, incluindo a figma-use, que esta skill carrega junto. Depois execute /mcp e entre no Figma. Se você copiar as pastas à mão, os comandos abaixo também copiam a figma-use.
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpNo Cursor, no Gemini CLI e no VS Code
O guia da Figma instala o mesmo plugin no Cursor (/add-plugin figma) e no Gemini CLI (uma extensão, depois /mcp auth figma), e conecta o VS Code por um servidor MCP HTTP com a mesma URL.
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guideConfira se a animação funciona na sua conta
Antes de um pedido grande, peça algo pequeno, como fazer uma camada aparecer com fade. Se o agente informar que uma propriedade de animação é “not a supported API”, a animação ainda não está ativada para você, e nenhuma configuração da skill muda isso.
Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:
Claude Code: pelo marketplace de plugins
- Abra o Claude Code em um terminal com
claude. - Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
- Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
/plugin install figma@claude-plugins-official - Digite / e procure
/figma:figma-use-motion, ou simplesmente peça a tarefa.
Pelo shell, em vez de dentro de uma sessão:
claude plugin install figma@claude-plugins-officialO plugin é instalado inteiro, então outras skills vêm junto, incluindo 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: copie a pasta para a sua pasta de skills
Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).
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/O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /figma-use-motion ou apenas descreva a tarefa.
No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.
Codex, Gemini CLI, Cursor e GitHub Copilot
Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:
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/| Agente | Pasta do projeto | Sua pasta de usuário | Observações |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente). |
Fontes destas instruções
Conferido com a documentação de cada fornecedor em 2026-11-14:
A checklist de animação
A checklist prévia da skill pega os erros mais comuns dos scripts de animação: nomes internos de easing em vez dos públicos, o alias inválido para ease-in-and-out, animar um frame de nível superior em vez das camadas dentro dele, valores de timeline em milissegundos em vez de segundos e nomes internos de campos de transformação que geram erro.
A animação de texto sempre usa o stagger de texto nativo na camada de texto existente, para que os caracteres continuem editáveis, e a duração dela é o intervalo total do stagger, não o tempo por caractere.
Fazer cada exportação de vídeo valer a pena
Como as exportações são lentas e custam tempo real de renderização, a skill escolhe primeiro os momentos a conferir (normalmente de quatro a seis quadros, um por fase), renderiza em tamanho pequeno e com taxa de quadros baixa, depois lê todos os quadros e junta todas as correções em uma única passada antes de renderizar de novo.
Perguntas sobre a skill figma-use-motion
Qual é a diferença entre a figma-use-motion e a figma-implement-motion?
A figma-use-motion cria e edita animações dentro do arquivo do Figma. A figma-implement-motion lê uma animação do Figma e a escreve como código no seu projeto. Use a primeira para criar a animação e a segunda para colocá-la em produção.
Por que o agente diz que a animação não é compatível?
O Figma Motion está em beta aberto, e a skill avisa que as APIs dele podem não estar ativadas para todos os usuários; estilos de animação personalizados e animação 3D podem estar indisponíveis separadamente. Quando uma chamada falha com “is not a supported API”, a skill manda o agente parar e avisar você em vez de tentar de novo.
O agente consegue ver a animação que criou?
Não por uma captura de tela, que só mostra o estado de repouso. Para conferir a animação, ele exporta um MP4 pequeno, com taxa de quadros baixa, do frame pela ferramenta export_video do Figma e extrai alguns quadros com ffmpeg. A exportação é renderizada nos servidores da Figma e pode levar minutos, então a skill planeja cada renderização e a dispensa em mudanças óbvias.
Ela precisa da figma-use?
Sim. A figma-use contém as regras da Plugin API para todo script use_figma, e a figma-use-motion acrescenta as específicas de animação; a skill diz para carregar as duas juntas. O plugin da Figma instala as duas.
A skill figma-use-motion é grátis?
Os arquivos são grátis para instalar, mas não são de código aberto: não há arquivo de licença e valem os Developer Terms da Figma. Você precisa de uma conta no Figma com o Figma Motion disponível e de um assento Full para gravar fora dos seus rascunhos, e a Figma diz que gravar no canvas passará a ser pago, cobrado por uso, depois do beta.
Mais skills de IA
Skills relacionadas
Skill Figma Implement Motion
Oficial · FigmaA skill da Figma para transformar animações feitas no Figma em código: motion.dev para React, keyframes CSS para outros sites, com timing e easing exatos.Skill Figma Use (use_figma)
Oficial · FigmaA skill base por trás de toda gravação no Figma: as regras que um agente segue ao rodar scripts da Plugin API no seu arquivo pelo use_figma.Skill Figma Generate Design
Oficial · FigmaA skill da Figma para criar ou atualizar telas em um arquivo do Figma a partir do seu código, usando os componentes e variáveis do seu design system.Design de miniaturas skill
Comunidade · Frank HeijdenrijkPlaneje miniaturas de vídeo honestas e legíveis no celular, com teste comparativo nativo.Design e modelos skill
Comunidade · Frank HeijdenrijkDefina kit de marca reutilizável, família de modelos e fluxo de produção para gráficos sociais recorrentes.Cartões de citações e gráficos de texto skill
Comunidade · Frank HeijdenrijkEscolha e atribua uma frase forte e planeje um cartão tipográfico legível sem fabricar citações.