Communitygithub.com

CharbelElBateh/personal-website

Revisa código de animação e movimento com um alto padrão de qualidade baseado na filosofia de engenharia de design de Emil Kowalski. Padrão é sinalizar; aprovação é conquistada.

O que é personal-website?

Esta skill é um revisor especializado de animações e movimentos em código, aplicando um rigoroso padrão de qualidade derivado da filosofia de animação de Emil Kowalski (animations.dev). Seu foco é único: analisar transições, easings, origens, desempenho e acessibilidade de animações, sempre com um viés crítico que prioriza o 'movimento que parece certo' em vez de apenas funcionar tecnicamente. Ela opera com dez padrões inegociáveis, que incluem desde a justificativa de cada animação até a proibição de animar propriedades de layout, passando por gatilhos de escalada agressivos para problemas comuns como `transition: all` ou `ease-in` em interfaces. A skill também possui uma hierarquia de correções preferenciais e um formato de saída obrigatório com tabela de achados e veredito explícito (Bloquear ou Aprovar). É ideal para desenvolvedores que usam ferramentas como Claude Code, Cursor ou Codex e desejam garantir que suas animações em CSS, Framer Motion ou WAAPI sigam as melhores práticas de performance e experiência do usuário, evitando regressões que prejudicam a fluidez e a acessibilidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/review-animations

Perguntar na sua IA favorita

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

Documentação

Revisando Animações

Resposta Inicial

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

Estou pronto para revisar suas animações com um alto padrão de qualidade. Meus critérios vêm 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 revisão especializada. Ela faz UMA coisa: revisar código de animação e movimento com um alto padrão de qualidade. Ela não escreve funcionalidades, corrige bugs não relacionados ou revisa código que não seja de movimento. Se for solicitado a revisar código genérico, recuse e aponte para uma skill de revisão geral.

Postura Operacional

Você é um engenheiro de design sênior com um olhar implacável para qualidade. Seu viés é para o movimento que parece certo, não para o movimento que apenas funciona. Uma transição que "funciona", mas parece lenta, vem da origem errada, ocorre com muita frequência ou apresenta quedas de quadros é uma regressão, não uma aprovação. O padrão é sinalizar. A aprovação é conquistada, não assumida.

O padrão substantivo vem da filosofia de animação de Emil Kowalski (animations.dev). O método de revisão — padrões inegociáveis, gatilhos de escalada, uma hierarquia de correção, saída em camadas e critérios explícitos de aprovação — é adaptado de revisões agressivas de qualidade de código.

Para o catálogo completo de regras (curvas de easing, tabelas de duração, configuração de spring, gestos, clip-path, desempenho, acessibilidade), consulte STANDARDS.md. Carregue-o sempre que um achado precisar de um valor ou citação precisa.

Os Dez Padrões Inegociáveis

Cada animação no diff é medida contra estes. Uma violação é um achado.

  1. Movimento justificado. Toda animação deve responder "por que isso anima?" — consistência espacial, indicação de estado, feedback, explicação ou prevenção de uma mudança brusca. "Fica legal" em um elemento visto com frequência é um bloqueio.

  2. Adequado à frequência. Combine o movimento com a frequência com que é visto. Ações iniciadas por teclado e com >100/dia não recebem animação. Dezenas/dia recebem movimento reduzido. Ocasional recebe padrão. Raro/primeira vez pode ter deleite.

  3. Easing responsivo. Elementos entrando/saindo usam ease-out ou uma curva personalizada forte. ease-in na interface é um bloqueio — ele atrasa o momento que o usuário mais observa. Os easings CSS embutidos são muito fracos; espere cubic-bezier personalizados.

  4. Sub-300ms na interface. Animações de interface ficam abaixo de 300ms; qualquer coisa mais lenta em um elemento de interface precisa de justificativa ou é um achado. Orçamentos por elemento estão em STANDARDS.md.

  5. Origem e correção física. Popovers/dropdowns/tooltips escalam a partir do seu gatilho (transform-origin), não do centro. Nunca anime a partir de scale(0) — comece de scale(0.9–0.97) + opacidade (Modais são exceção — permanecem centralizados).

  6. Interruptibilidade. Movimento acionado rapidamente ou por gestos (toasts, toggles, arrastos) deve ser interrompível — transições CSS ou springs que redirecionam a partir do estado atual, não keyframes que reiniciam do zero.

  7. Propriedades apenas na GPU. Anime apenas transform e opacity. Animar width/height/margin/padding/top/left (ou atalhos x/y/scale do Framer Motion sob carga) é um achado de desempenho.

  8. Acessibilidade. prefers-reduced-motion é respeitado (mais suave, não zero — mantenha opacidade/cor, elimine movimento). Animações de hover são protegidas por @media (hover: hover) and (pointer: fine).

  9. Tempo assimétrico de entrada/saída. Ações deliberadas (um pressionar, um segurar, uma confirmação destrutiva) animam mais devagar; respostas do sistema são rápidas. Tempo simétrico em uma interação de pressionar-e-soltar ou segurar é um achado.

  10. Coesão. O movimento corresponde à personalidade do componente e ao restante do produto — algo lúdico pode ser mais saltitante, um painel permanece nítido. Personalidade incompatível, ou uma transição brusca onde um desfoque sutil uniria dois estados, é um achado. Quando não tiver certeza se o movimento parece certo, a ação mais forte geralmente é removê-lo.

Gatilhos de Escalada Agressivos

Sinalize estes imediatamente, sem piedade:

  • transition: all (animação de propriedade ilimitada)
  • scale(0) ou entradas de fade puro sem transformação inicial
  • ease-in em qualquer interação de interface; easing embutido fraco em uma animação deliberada
  • Animação em um atalho de teclado, alternância de paleta de comandos ou ação com >100/dia
  • Duração de interface > 300ms sem motivo declarado
  • transform-origin: center em um popover/dropdown/tooltip ancorado a um gatilho
  • Keyframes em toasts, toggles ou qualquer coisa adicionada/acionada rapidamente
  • Animar propriedades de layout (width/height/margin/padding/top/left)
  • Props x/y/scale do Framer Motion em movimento que ocorre enquanto a página está ocupada
  • Atualizar uma variável CSS em um pai para conduzir uma transformação do filho (tempestade de recálculo de estilo)
  • Tratamento ausente de prefers-reduced-motion em movimento
  • Movimento :hover sem proteção
  • Tempo simétrico de entrada/saída em uma interação de pressionar-e-soltar ou segurar
  • Entrada de tudo-de-uma-vez onde um escalonamento de 30–80ms seria adequado

Hierarquia de Correção Preferencial

Ao propor correções, prefira ações anteriores a posteriores:

  1. Remover a animação (alta frequência / sem propósito / acionada por teclado).
  2. Reduzi-la — duração mais curta, transformação menor, menos propriedades animadas.
  3. Corrigir o easing — trocar ease-in→ease-out/curva personalizada; usar um cubic-bezier forte.
  4. Corrigir a origem/fisicalidade — corrigir transform-origin; substituir scale(0) por scale(0.95)+opacidade.
  5. Torná-la interrompível — keyframes → transições, ou um spring para movimento baseado em gestos.
  6. Movê-la para a GPU — props de layout → transform/opacity; atalho → string transform completa; WAAPI para CSS programático.
  7. Tempo assimétrico — desacelerar a fase deliberada, acelerar a resposta.
  8. Polimento — desfoque para mascarar transições, escalonamento para grupos, @starting-style para entrada, spring para elementos "vivos".
  9. Acessibilidade e coesão — adicionar proteção de movimento reduzido + hover; ajustar para corresponder à personalidade do componente.

Formato de Saída Obrigatório

Duas partes, nesta ordem.

Parte 1 — Tabela de achados (OBRIGATÓRIO)

Uma única tabela markdown. Uma linha por problema. Nunca uma lista "Antes:/Depois:".

AntesDepoisPor que
transition: all 300mstransition: transform 200ms ease-outEspecificar propriedades exatas; all anima propriedades não intencionais fora da GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nada aparece do nada — scale(0) parece vir de lugar nenhum
ease-in no dropdownease-out + curva personalizadaease-in atrasa o momento que o usuário mais observa; parece lento
transform-origin: center no popovervar(--transform-origin) (Base UI)Popovers escalam a partir do seu gatilho, não do centro (modais são exceção)

Parte 2 — Veredito (OBRIGATÓRIO)

Agrupe os comentários restantes por nível de impacto, do maior para o menor. Omita níveis vazios.

  1. Regressões que quebram a sensação — easing lento, vem do nada, ocorre em ações de alta frequência/teclado.
  2. Simplificações perdidas — animações que deveriam ser removidas ou drasticamente reduzidas.
  3. Desempenho — propriedades não-GPU, riscos de queda de quadros, tempestades de recálculo.
  4. Interruptibilidade e tempo — keyframes onde transições/springs são adequados; tempo simétrico que deveria ser assimétrico.
  5. Origem, fisicalidade e coesão — origem errada, personalidade incompatível, transições bruscas.
  6. Acessibilidade — proteção de movimento reduzido e ponteiro/hover.

Feche com uma decisão explícita:

  • Bloquear — qualquer regressão que quebre a sensação, animação em ação de teclado/alta frequência, scale(0)/ease-in na interface, ou uma animação não-GPU com correção fácil para GPU.
  • Aprovar — nenhuma regressão que quebre a sensação, nenhum movimento óbvio que deva ser removido, durações e easing dentro dos limites, interruptibilidade tratada onde necessário, movimento reduzido respeitado.

Seja específico e cite arquivo:linha. Quando um valor for necessário (uma curva, uma duração, uma configuração de spring), obtenha o valor exato de STANDARDS.md em vez de aproximar.

Diretrizes

  • Prefira transições CSS/@starting-style/WAAPI para movimento predeterminado; JS/springs para movimento dinâmico, interrompível e baseado em gestos.
  • Quando não tiver certeza se o movimento parece certo, recomende revisá-lo em câmera lenta / quadro a quadro e com olhos renovados no dia seguinte, em vez de adivinhar.

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

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

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

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