Communitygithub.com

CharbelElBateh/personal-website

Construa uma animação do zero, tomando as decisões na ordem que determina se ela parece certa — deve animar, 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 um codebase inteiro use improve-animations.

O que é personal-website?

Esta skill é uma ferramenta especializada para desenvolvimento de animações front-end, baseada na filosofia de Emil Kowalski. Em vez de oferecer um menu de opções, ela segue uma sequência rigorosa de sete etapas para garantir que cada animação seja construída com decisões intencionais: primeiro, avalia se a animação é necessária com base na frequência de uso (des cartando animações para ações acionadas por teclado ou usadas mais de 100 vezes ao dia); em seguida, nomeia o propósito exato (feedback, consistência espacial, indicação de estado, etc.); depois seleciona a ferramenta mais leve que funciona (CSS transition, @starting-style, CSS animation, WAAPI ou Motion); escolhe propriedades GPU-friendly como transform e opacity; aplica curvas de easing e durações pré-definidas (nunca inventadas); implementa interrupção e saída adequadas; e finalmente adiciona suporte a movimento reduzido e hover em dispositivos com ponteiro. A skill também inclui sete regras rígidas, como não usar valores aproximados, não animar com `transition: all`, não usar `scale(0)` e nunca aplicar `ease-in` em elementos de UI. É compatível com CSS, Motion (motion.dev) e JavaScript puro via WAAPI. O resultado é código pronto para revisão, acompanhado de um resumo conciso das decisões tomadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/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 skill for invocada pela primeira vez sem uma pergunta específica, responda apenas com:

Estou pronto para construir animações que pareçam 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 skill 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 um codebase (isso é improve-animations), não critica um diff (isso é review-animations), não procura lugares que poderiam animar (isso é find-animation-opportunities) e não 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 impõe. Escreva de forma que passe nessa revisão na primeira vez.

Dois modos de falha, e o primeiro é pior:

  1. Animar algo que não deveria animar. O portal abaixo existe para produzir zero linhas de código às vezes. Isso é um sucesso, não uma fuga.
  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. Os passos 1 e 2 são o portal para tudo. Não busque uma curva antes de saber se algo anima ou não.
  2. Sem valores aproximados. Toda curva, duração e configuração de mola vem das tabelas abaixo. Nunca invente cubic-bezier(0.4, 0, 0.2, 1) porque parece familiar.
  3. Estenda os tokens do codebase, não crie forks. Se --ease-out ou uma escala de duração já existir, use-a. Adicionar um sistema paralelo é um defeito.
  4. Movimento reduzido e hover com gate acompanham a animação, não como algo posterior.
  5. Ferramenta mais barata que funciona. Não instale uma biblioteca de movimento para um 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)Nenhuma animação. Nunca. 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 uma questão de 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 portal, 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).

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
  • Prevenir uma mudança abrupta — 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 é uma razão 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 encaixa.

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

Css animations vencem JS sob carga — elas são executadas fora da thread principal, enquanto animações baseadas em requestAnimationFrame perdem quadros enquanto o navegador carrega, executa scripts 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. Fazer isso manualmente é como você acaba com um <div> dropdown e sem gerenciamento de foco.

4. Escolha as propriedades

  • transform e opacity apenas. Elas pulam layout e pintura e são executadas na GPU. width/height/margin/padding/top/left acionam todos os três. (clip-path é a quarta sancionada — veja RECIPES.md. height é tolerada apenas para acordeões, onde não há equivalente de 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; eles 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 sua própria altura qualquer que seja o conteúdo. Prefira em vez de pixels fixos.
  • No Motion, use a string de transform completa. Shorthands 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 o 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. Easing e duração — ou uma mola

Easing, em ordem de decisão:

SituaçãoEasing
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 em UI. Começa devagar, atrasando o exato momento que o usuário está observando. ease-out a 200ms parece mais rápido que ease-in a 200ms.

Easings CSS embutidos são muito fracos. Use estes:

--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 UI ficam abaixo de 300ms. Um dropdown de 180ms parece mais responsivo que um de 400ms.

Recorra a uma mola quando o movimento é 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 o bounce entre 0.1–0.3 e evite bounce na maioria das UI — reserve 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 a partir do valor atual; keyframes reiniciam do zero.
  • Molas 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 faz o deslizar para dispensar parecer óbvio.
  • Tempo assimétrico onde o usuário está decidindo. Lento na fase deliberada (um pressionar para confirmar: 2s linear), rápido na resposta do sistema (liberação: 200ms ease-out).

7. Movimento reduzido e gate 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 ao tocar */
}
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, acordeão, stagger, pressionar para confirmar, indicador de aba, revelação de scroll, arrastar para dispensar — veja RECIPES.md. Carregue sempre que a solicitação corresponder a um desses componentes; comece a partir da receita em vez de um arquivo em branco.

Nunca Enviar

Auto-verificação 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 UIease-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 100+/diaNenhuma animação
Duração de UI acima de 300ms sem motivo150–250ms
transform-origin: center em um popover ancorado a um 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 gate@media (hover: hover) and (pointer: fine)
prefers-reduced-motion ausenteVariante mais suave, não zero
Tudo entrando ao mesmo tempoStagger de 30–80ms

Saída

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

  • O resultado do portal — 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 mola, em uma linha cada.
  • O que verificar na sensação — se o resultado depende da sensação que você não pode julgar a partir do código (um crossfade, o bounce de uma mola, o equilíbrio opacidade/altura em uma lista que entra), diga e aponte para a verificação: reproduza a 2–5× a duração ou no inspetor de animação do 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 skill existe. Quando a sensação genuinamente não puder ser determinada a partir do código, diga em vez de adivinhar um valor.

Individual skills in this repo

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

CharbelElBateh/personal-website

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`.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

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

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Habilidades Relacionadas