Pular para o conteúdo

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
AutorFigma
LicençaNo licence file; Figma Developer Terms apply
Fontefigma/mcp-server-guide · SKILL.md no GitHub
Site do projetodevelopers.figma.com/docs/figma-mcp-server
Funciona emClaude 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.

Esta é uma skill oficial de Figma. Como qualquer skill, ela dá instruções ao agente e pode incluir scripts que ele executa, então instale-a a partir da fonte indicada aqui, não de uma cópia em outro lugar.

O que ela faz

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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 pastaPara que serve
SKILL.mdControle 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.mdTrilhas de keyframes, campos animáveis, trilhas de cor e de efeito, estilos de animação e duração da timeline.
references/motion-custom-styles.mdComo encontrar, criar, editar, aplicar e remover os estilos de animação reutilizáveis do próprio arquivo.
references/text-animation.mdRevelações de texto tipo máquina de escrever e escalonadas com o stagger de texto nativo, mantendo o texto editável.
references/motion-easing.mdObjetos de easing, curvas cubic e spring personalizadas, e hold.
references/3d-transforms.mdInclinaçã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/mcp

No 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-guide

Confira 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

  1. Abra o Claude Code em um terminal com claude.
  2. Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
  3. 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
  4. 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-official

O 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/
AgentePasta do projetoSua pasta de usuárioObservaçõ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).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

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

Categorias de skills