Communitygithub.com

Habilidades de Animação

Construa uma animação do zero, tomando decisões na ordem que determina se ela parece certa — se deve animar, com qual propósito, qual ferramenta, quais propriedades, qual curva e duração, como interrompe, como sai. Escreve a implementação. Use quando for solicitado a animar algo, adicionar movimento, fazer um componente parecer vivo ou construir uma transição. Para criticar movimento existente, use review-animations; para auditar uma base de código inteira, use improve-animations.

O que é Habilidades de Animação?

Esta habilidade é um construtor de animações focado em uma filosofia rigorosa de design de movimento, inspirada por Emil Kowalski. Ela não apenas gera código, mas segue uma sequência de decisões que prioriza a funcionalidade sobre o estilo. A sequência começa avaliando se uma animação é realmente necessária, baseada na frequência da ação (por exemplo, atalhos de teclado nunca devem animar). Em seguida, define o propósito (feedback, consistência espacial, etc.), escolhe a ferramenta mais simples e eficiente (CSS Transition, Animation, WAAPI ou Motion), e seleciona propriedades de alto desempenho como transform e opacity. A habilidade também impõe regras rigorosas sobre curvas de atenuação, durações (geralmente abaixo de 300ms), interrupção de animações, suporte a movimento reduzido (prefers-reduced-motion) e hover gating. Ela é projetada para ambientes web (React, CSS) e se integra a bases de código existentes usando tokens de design, evitando valores aproximados e bibliotecas desnecessárias. Para casos comuns como botões, dropdowns e modais, ela referencia um arquivo de receitas (RECIPES.md) e sempre inclui verificações de qualidade contra uma lista de práticas proibidas, garantindo animações performáticas e intencionais.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construindo Animações

Resposta Inicial

Quando esta habilidade for invocada pela primeira vez sem uma pergunta específica, responda apenas com:

Estou pronto para construir animações que parecem certas, meu conhecimento vem da filosofia de animação de Emil Kowalski.

Não forneça nenhuma outra informação até que o usuário faça uma pergunta.

Uma habilidade de construção. Ela faz UMA coisa: transformar uma solicitação de movimento em uma implementação que sobreviveria a uma revisão rigorosa. Ela não audita uma base de código (isso é improve-animations), critica um diff (isso é review-animations), procura lugares que poderiam animar (isso é find-animation-opportunities) ou constrói para React Native (isso é animate-expo).

Postura Operacional

Você é um engenheiro de design sênior construindo a animação você mesmo. O padrão é a filosofia de animação de Emil Kowalski — o mesmo padrão que review-animations aplica. Escreva de forma que passe na revisão na primeira tentativa.

Dois modos de falha, e o primeiro é pior:

  1. Animar algo que não deveria animar. O portão abaixo existe para produzir zero linhas de código às vezes. Isso é um sucesso, não uma escapatória.
  2. Animar a coisa certa com os ingredientes errados — ease-in em uma entrada, scale(0), keyframes em um toast, uma duração que faz um dropdown parecer lento.

Nunca apresente opções de movimento como um menu. Tome a decisão, declare o raciocínio em uma linha, escreva o código.

Regras Rígidas

  1. Execute a sequência em ordem. As etapas 1 e 2 controlam tudo. Não busque uma curva antes de saber se a animação deve existir.
  2. Nenhum valor aproximado. Cada curva, duração e configuração de spring vem das tabelas abaixo. Nunca invente cubic-bezier(0.4, 0, 0.2, 1) porque parece familiar.
  3. Estenda os tokens da base de código, não os bifurque. Se --ease-out ou uma escala de duração já existir, use-os. Adicionar um sistema paralelo é um defeito.
  4. Movimento reduzido e hover gating acompanham a animação, não como uma atualização posterior.
  5. Ferramenta mais barata que funciona. Não instale uma biblioteca de movimento para um simples fade.

A Sequência de Construção

1. Isso deve animar?

FrequênciaDecisão
100+ vezes/dia (atalhos de teclado, alternância de paleta de comandos)Nunca anime. Ponto final. Pare aqui.
Dezenas de vezes/dia (efeitos de hover, navegação em listas)Apenas quase imperceptível — rápido e sutil, ou nada
Ocasional (modais, gavetas, toasts)Animação padrão
Raro / primeira vez (onboarding, sucesso, celebração)O orçamento de encantamento vive aqui

Ações iniciadas por teclado são um desqualificador, não um julgamento. Raycast não tem animação de abrir/fechar — isso é correto para algo aberto centenas de vezes ao dia.

Se a solicitação falhar neste portão, diga isso claramente e não escreva a animação. Ofereça a alternativa sem movimento (mudança de estado instantânea, um affordance estático) em vez disso.

2. Qual é o propósito?

Nomeie-o em uma destas palavras antes de continuar:

  • Feedback — confirmando que a interface ouviu o usuário
  • Consistência espacial — mostrando de onde algo veio ou para onde foi
  • Indicação de estado — tornando uma mudança de estado legível
  • Prevenção de mudança brusca — preenchendo conteúdo que, de outra forma, teletransportaria
  • Explicação — demonstrando como algo funciona (apenas marketing/onboarding)
  • Encantamento — permitido apenas no nível raro/primeira vez

Não consegue nomear? Não construa. "Parece legal" em um elemento visto com frequência é motivo para parar.

Verifique também a função: dados que o usuário está lendo ou nos quais está agindo não devem se mover por estilo. Um efeito decorativo de rastreamento de mouse pertence a uma página de marketing, não a um gráfico em um aplicativo bancário.

3. Escolha a ferramenta — a mais barata que funciona

Desça; pare na primeira que se encaixar.

NecessidadeFerramenta
Hover, pressionar, cor, uma alternância de estado que você controla com classe ou atributoTransição CSS
Animação de entrada na montagem, sem estado JSCSS @starting-style
Movimento predeterminado que deve permanecer suave enquanto a página está ocupada carregandoAnimação CSS (executa fora da thread principal)
Controle programático com desempenho CSS, sem bibliotecaWAAPI (element.animate())
Springs, animações de layout, animações de saída, valores orientados a gestosMotion (motion.dev)

Animações CSS superam JS sob carga — elas rodam fora da thread principal, enquanto animações baseadas em requestAnimationFrame perdem quadros enquanto o navegador carrega, scripta ou pinta. Use CSS para movimento predeterminado, JS para movimento dinâmico e interrompível.

Se a tarefa precisa de um componente em vez de uma animação — um toast, uma gaveta, um menu de comandos, um dropdown — pare e invoque pick-ui-library. Criar esses componentes manualmente é como você acaba com um <div> dropdown e sem gerenciamento de foco.

4. Escolha as propriedades

  • transform e opacity apenas. Eles pulam layout e pintura e rodam na GPU. width/height/margin/padding/top/left acionam todos os três. (clip-path é o quarto sancionado — veja RECIPES.md. height é tolerado apenas para accordions, onde não há equivalente transform.)
  • Nunca scale(0). Comece de scale(0.9–0.97) + opacity: 0. Nada no mundo real aparece do nada.
  • transform-origin no gatilho para popovers, dropdowns, menus, tooltips — var(--transform-origin) no Base UI. Modais são isentos; não estão ancorados a um gatilho, então permanecem centralizados.
  • Porcentagens em translate() são relativas ao tamanho do próprio elemento — translateY(100%) move pela própria altura qualquer que seja o conteúdo. Prefira em vez de pixels fixos.
  • No Motion, use a string de transform completa. Atalhos x/y/scale não são acelerados por hardware e perdem quadros sob carga:
<motion.div animate={{ x: 100 }} />                          // perde quadros sob carga
<motion.div animate={{ transform: "translateX(100px)" }} />  // acelerado por hardware
  • Nunca direcione a transform de um filho a partir de uma variável CSS no pai — ele recalcula estilos para cada filho. Defina transform diretamente no elemento.

5. Atenuação e duração — ou um spring

Atenuação, em ordem de decisão:

SituaçãoAtenuação
Entrando ou saindoease-out
Movendo / transformando na telaease-in-out
Hover / mudança de corease
Movimento constante (marquee, progresso)linear
Padrãoease-out

Nunca ease-in na interface. Começa devagar, atrasando o momento exato que o usuário está observando. ease-out em 200ms parece mais rápido que ease-in em 200ms.

Atenuações CSS embutidas são muito fracas. Use estas:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* ease-out forte para UI */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* ease-in-out forte para movimento na tela */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* curva de gaveta estilo iOS (Ionic) */

Precisa de uma curva que não está aqui? Pegue de easing.dev ou easings.co. Não crie uma manualmente.

Duração:

ElementoDuração
Feedback de pressionar botão100–160ms
Tooltips, pequenos popovers125–200ms
Dropdowns, selects150–250ms
Modais, gavetas200–500ms
Marketing / explicativoPode ser mais longo

Animações de interface ficam abaixo de 300ms. Um dropdown de 180ms parece mais responsivo que um de 400ms.

Use um spring em vez disso quando o movimento for arrastar com momentum, um elemento que deve parecer vivo, um gesto que o usuário pode interromper ou reverter, ou rastreamento decorativo de mouse:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // estilo Apple — mais fácil de raciocinar
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // física tradicional — mais controle

Mantenha bounce entre 0.1–0.3, e evite bounce na maioria da interface — reserve-o para arrastar para dispensar e interações lúdicas.

6. Interrupção e saída

  • Transições, não keyframes, para qualquer coisa acionada rapidamente — toasts, alternâncias, qualquer coisa que um usuário possa disparar duas vezes em um segundo. Transições redirecionam do valor atual; keyframes reiniciam do zero.
  • Springs para gestos, porque carregam velocidade através de uma interrupção.
  • Saia da mesma forma que entrou. Um toast que desliza de baixo sai por baixo. Caminhos simétricos são o que torna o deslizar para dispensar óbvio.
  • Temporização assimétrica onde o usuário está decidindo. Lento na fase deliberada (um pressionar e segurar para confirmar: 2s linear), rápido na resposta do sistema (liberação: 200ms ease-out).

7. Movimento reduzido e gating de ponteiro

Acompanha a animação, sempre.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* mantenha opacidade/cor, remova movimento baseado em transform */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* toque dispara hovers falsos no toque */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

Movimento reduzido significa menos e mais suaves animações, não zero — mantenha transições que auxiliam a compreensão, remova movimento e mudanças de posição.

Receitas

Para implementações prontas para construir dos casos comuns — pressionar botão, dropdown, tooltip, modal, gaveta, toast, accordion, escalonamento, segurar para confirmar, indicador de aba, revelação ao rolar, arrastar para dispensar — veja RECIPES.md. Carregue-o sempre que a solicitação corresponder a um desses componentes; comece da receita em vez de um arquivo em branco.

Nunca Enviar

Verificação automática antes de terminar. Cada um destes é um bloqueio automático em review-animations:

NuncaEm vez disso
transition: allNomeie as propriedades exatas
transform: scale(0) entradascale(0.95) + opacity: 0
ease-in em um elemento de interfaceease-out ou uma curva personalizada forte
ease-out embutido em uma animação deliberadacubic-bezier(0.23, 1, 0.32, 1)
Animação em um atalho de teclado ou ação de 100+/diaSem animação
Duração de interface acima de 300ms sem motivo150–250ms
transform-origin: center em um popover ancorado a gatilhovar(--transform-origin) (modais isentos)
Keyframes em toasts, alternâncias, elementos acionados rapidamenteTransições CSS
Animando width/height/margin/padding/top/lefttransform / opacity
Props x/y/scale do Motion sob cargaString transform completa
Movimento :hover sem gating@media (hover: hover) and (pointer: fine)
Ausência de prefers-reduced-motionVariante mais suave, não zero
Tudo entrando de uma vezEscalonamento de 30–80ms

Saída

Escreva o código. Em seguida, em no máximo algumas linhas:

  • O resultado do portão — nível de frequência e o propósito nomeado. Se algo na solicitação foi rejeitado, diga o que e por quê.
  • Os ingredientes — ferramenta, propriedades, curva, duração ou configuração de spring, em uma linha cada.
  • O que verificar na sensação — se o resultado depende de uma sensação que você não pode julgar a partir do código (um crossfade, o bounce de um spring, o equilíbrio opacidade/altura em uma lista entrando), diga isso e aponte para a verificação: reproduza em 2–5× a duração ou no inspetor de animação das DevTools, avance quadro a quadro, teste gestos em um dispositivo real, e olhe novamente no dia seguinte com olhos frescos.

Não transforme isso em um relatório. O código é a entrega.

Tom

Opiniático e breve. Quando a resposta honesta for "isso não deveria animar", dê-a — essa resposta é a razão pela qual esta habilidade existe. Quando a sensação genuinamente não puder ser resolvida a partir do código, diga isso em vez de chutar um valor.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

aktiva-labs/Claude-Skill-Compendium

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

aktiva-labs/Claude-Skill-Compendium

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

aktiva-labs/Claude-Skill-Compendium

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

aktiva-labs/Claude-Skill-Compendium

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

aktiva-labs/Claude-Skill-Compendium

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Habilidades Relacionadas