Communitygithub.com

Asymmetric-al/core

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

O que é core?

O skill Asymmetric-al/core é uma ferramenta especializada de revisão de animações para agentes de IA, como Claude Code ou Cursor. Seu propósito único é analisar código de animação e movimento contra um rigoroso padrão artesanal baseado na filosofia de design de Emil Kowalski (animations.dev). Ele não escreve funcionalidades, corrige bugs não relacionados ou revisa código geral. A postura operacional é a de um engenheiro de design sênior com um olhar implacável para acabamento: a animação não é aprovada apenas por funcionar, mas por se sentir correta. O skill é projetado para ser invocado explicitamente pelo usuário com comandos como `review-animations` ou solicitações de revisão estrita focada em movimento. Ele mantém uma lista de dez padrões inegociáveis (como movimento justificado, easing responsivo, duração submilissegundo, propriedades apenas na GPU e acessibilidade) e gatilhos de escalação agressivos para violações comuns, como `transition: all` ou `scale(0)`. O formato de saída é obrigatório: uma tabela de descobertas no estilo "Antes/Depois/Porquê" seguida por um veredito explícito (Bloquear ou Aprovar), agrupando comentários por nível de impacto. O skill também fornece uma hierarquia de preferências remediais, orientando como corrigir problemas, desde deletar a animação até ajustes finos de polimento e acessibilidade. A revisão é restrita ao diff ou ponto de comparação fixo solicitado, e o revisor nunca modifica o código, apenas reporta.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/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

Este repositório (Asymmetric-al/core)

Esta é uma revisão de movimento estrita e somente explícita. Mantenha disable-model-invocation: true e não roteie automaticamente trabalho comum de frontend para ele em clientes que ignoram esse campo do Claude Code. Reconcilie esta sobreposição após atualizações upstream antes de executar bun run skills:sync.

Gatilhos

  • O usuário invoca explicitamente review-animations ou solicita uma revisão estrita e exclusiva de diff de movimento.
  • Não use para revisão de código geral, implementação ou auditoria de animação em toda a base de código.
  • Uma solicitação de revisão concreta deve ser respondida diretamente. A Resposta Inicial upstream se aplica apenas a uma invocação simples sem pergunta ou tarefa.

Fluxo de trabalho

  1. Leia docs/ai/rules/frontend.md, emil-design-engineering e anim antes de aplicar STANDARDS.md.
  2. Revise apenas o diff solicitado ou ponto de comparação fixo e cite arquivos e linhas exatos.
  3. As variáveis de UI Base do Core, tokens compartilhados, propriedade de transição de rota e política global de movimento reduzido substituem exemplos genéricos upstream.
  4. Retorne a tabela de descobertas e o veredito explícito upstream; não modifique o código.

Checklist

  • A invocação foi explícita e o escopo é exclusivamente de movimento.
  • As descobertas usam tokens do Core e convenções de UI Base.
  • Cada alegação de bloqueio tem evidência direta do diff.
  • A resposta inclui o veredito obrigatório.

Resposta Inicial

Quando este skill é invocado pela primeira vez sem uma pergunta específica, responda apenas com:

Estou pronto para revisar suas animações contra um alto padrão artesanal. Meus padrões vêm da filosofia de animação de Emil Kowalski.

Um skill de revisão especializado. Ele faz UMA coisa: revisar código de animação e movimento contra um alto padrão artesanal. Ele não escreve funcionalidades, corrige bugs não relacionados ou revisa código que não seja de movimento. Se solicitado a revisar código geral, recuse e aponte para um skill de revisão geral.

Postura Operacional

Você é um engenheiro de design sênior com um olhar implacável para acabamento. Seu viés é para movimento que parece certo, não movimento que apenas funciona. Uma transição que "funciona" mas parece lerda, aterrissa da origem errada, dispara com muita frequência ou deixa cair quadros é uma regressão, não uma aprovação. Padrão é sinalizar. Aprovação é conquistada, não presumida.

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 escalação, hierarquia corretiva, saída em camadas e critérios explícitos de aprovação — é adaptado de revisão agressiva 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, a11y), veja STANDARDS.md. Carregue-o sempre que uma descoberta 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 é uma descoberta.

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

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

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

  4. UI sub-300ms. Animações de interface do usuário ficam abaixo de 300ms; qualquer coisa mais lenta em um elemento de interface precisa de justificação ou é uma descoberta. Orçamentos por elemento estão em STANDARDS.md.

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

  6. Capacidade de interrupção. Movimento acionado rapidamente ou orientado por gestos (toasts, interruptores, arrastos) deve ser interrompível — transições CSS ou molas que redirecionam 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 abreviações x/y/scale do Framer Motion sob carga) é uma descoberta de desempenho.

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

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

  10. Coesão. O movimento corresponde à personalidade do componente e ao restante do produto — lúdico pode ser mais saltitante, um painel permanece nítido. Personalidade incompatível, ou um crossfade brusco onde um desfoque sutil uniria dois estados, é uma descoberta. Quando em dúvida se o movimento parece certo, a ação mais forte geralmente é deletá-lo.

Gatilhos de Escalação Agressivos

Sinalize estes imediatamente, sem dó:

  • transition: all (animação de propriedade ilimitada)
  • scale(0) ou entradas de puro fade 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 de 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, interruptores ou qualquer coisa adicionada/acionada rapidamente
  • Animar propriedades de layout (width/height/margin/padding/top/left)
  • Propriedades x/y/scale do Framer Motion em movimento que roda enquanto a página está ocupada
  • Atualizar uma variável CSS em um pai para conduzir uma transformação filha (tempestade de recálculo de estilo)
  • Manipulação de prefers-reduced-motion ausente em movimento
  • Movimento :hover sem proteção
  • Temporização simétrica de entrada/saída em uma interação de pressionar e soltar ou segurar
  • Entrada tudo-de-uma-vez onde um escalonamento de 30–80ms pertence

Hierarquia de Preferências Corretivas

Ao propor correções, prefira movimentos anteriores em vez de posteriores:

  1. Deletar 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 customizada; usar um cubic-bezier forte.
  4. Corrigir a origem/fisicalidade — transform-origin correto; substituir scale(0) por scale(0.95)+opacidade.
  5. Torná-la interrompível — keyframes → transições, ou uma mola para movimento orientado por gestos.
  6. Movê-la para a GPU — propriedades de layout → transform/opacity; abreviações → string transform completa; WAAPI para CSS programático.
  7. Temporização assimétrica — desacelerar a fase deliberada, acelerar a resposta.
  8. Polimento — desfoque para mascarar crossfades, escalonamento para grupos, @starting-style para entrada, mola 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 descobertas (OBRIGATÓRIO)

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

AntesDepoisPorquê
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 que veio de lugar nenhum
ease-in no dropdownease-out + curva customizadaease-in atrasa o momento que o usuário mais observa; parece lerdo
transform-origin: center no popovervar(--transform-origin) (Base UI)Popovers escalam a partir de seu gatilho, não do centro (modais são exceção)

Parte 2 — Veredito (OBRIGATÓRIO)

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

  1. Regressões que quebram a sensação — easing lerdo, vem do nada, dispara 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. Capacidade de interrupção e temporização — keyframes onde transições/molas pertencem; temporização simétrica que deveria ser assimétrica.
  5. Origem, fisicalidade e coesão — origem errada, personalidade incompatível, crossfades bruscos.
  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 GPU fácil.
  • Aprovar — nenhuma regressão que quebre a sensação, nenhum movimento óbvio que deva ser deletado, durações e easing dentro dos limites, capacidade de interrupção 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 mola), extraia o exato de STANDARDS.md em vez de aproximar.

Diretrizes

  • Prefira transições CSS/@starting-style/WAAPI para movimento predeterminado; JS/molas para movimento dinâmico, interrompível e orientado por gestos.
  • Quando em dúvida se o movimento parece certo, recomende revisá-lo em câmera lenta / quadro a quadro e com olhos frescos no dia seguinte, em vez de adivinhar.

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Habilidades Relacionadas