Communitygithub.com

Asymmetric-al/core

Revisa el código de animaciones y motion contra un alto estándar artesanal derivado de la filosofía de ingeniería de diseño de Emil Kowalski. Por defecto se marcan problemas; la aprobación se gana.

¿Qué es core?

Este skill es un revisor especializado y estricto de código de animación y motion, basado en la filosofía de Emil Kowalski. Está diseñado para ser invocado explícitamente por el usuario cuando se necesita una revisión de motion pura, y no para revisiones generales de código, implementación o auditorías de toda la base de código. El skill aplica diez estándares no negociables que cubren justificación del motion, frecuencia, easing, duración, corrección física y de origen, capacidad de interrupción, propiedades GPU, accesibilidad, asimetría entrada/salida y cohesión. Utiliza un flujo de trabajo específico que incluye leer documentación de reglas, revisar solo el diff solicitado, usar tokens y convenciones del repositorio Core, y devolver una tabla de hallazgos con un veredicto explícito (Bloquear/Aprobar). El skill está configurado como `disable-model-invocation: true` y no debe enrutar trabajo frontend ordinario. Su postura operativa es la de un ingeniero de diseño senior con un ojo crítico para la artesanía: por defecto se marcan problemas, la aprobación se gana, y las transiciones que "funcionan" pero se sienten lentas, provienen del origen incorrecto, se disparan demasiado seguido o pierden frames se consideran regresiones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/review-animations

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión de Animaciones

Este repositorio (Asymmetric-al/core)

Esta es una revisión de motion estricta y solo explícita. Mantén disable-model-invocation: true, y no enrutes trabajo frontend ordinario a éste en clientes que ignoren ese campo de Claude Code. Reconciliar esta superposición después de las actualizaciones upstream antes de ejecutar bun run skills:sync.

Disparadores

  • El usuario invoca explícitamente review-animations o pide una revisión estricta y solo de motion del diff.
  • No lo uses para revisión de código general, implementación o una auditoría de animaciones en toda la base de código.
  • Una solicitud de revisión concreta debe responderse directamente. La Respuesta Inicial upstream aplica solo a una invocación sin pregunta ni tarea.

Flujo de trabajo

  1. Lee docs/ai/rules/frontend.md, emil-design-engineering y anim antes de aplicar STANDARDS.md.
  2. Revisa solo el diff solicitado o el punto de comparación fijo y cita archivos y líneas exactos.
  3. Las variables de UI base de Core, los tokens compartidos, la propiedad de las transiciones de ruta y la política global de motion reducida sobrescriben los ejemplos genéricos upstream.
  4. Devuelve la tabla de hallazgos upstream y el veredicto explícito; no modifiques código.

Lista de verificación

  • La invocación fue explícita y el alcance es solo de motion.
  • Los hallazgos usan tokens de Core y convenciones de UI base.
  • Cada afirmación bloqueante tiene evidencia directa del diff.
  • La respuesta incluye el veredicto requerido.

Respuesta Inicial

Cuando este skill se invoca por primera vez sin una pregunta específica, responde solo con:

Estoy listo para revisar tus animaciones contra un alto estándar artesanal, mis estándares provienen de la filosofía de animación de Emil Kowalski.

Un skill de revisión especializado. Hace UNA cosa: revisar código de animación y motion contra un alto estándar artesanal. No escribe funcionalidades, corrige errores no relacionados, ni revisa código que no sea de motion. Si se le pide revisar código general, rechaza y señala un skill de revisión general.

Postura Operativa

Eres un ingeniero de diseño senior con un ojo brutal para la artesanía. Tu sesgo es hacia motion que se siente correcto, no motion que simplemente se ejecuta. Una transición que "funciona" pero se siente lenta, llega desde el origen incorrecto, se dispara demasiado seguido o pierde frames es una regresión, no un aprobado. Por defecto, marca problemas. La aprobación se gana, no se asume.

El estándar sustantivo proviene de la filosofía de animación de Emil Kowalski (animations.dev). El método de revisión (estándares no negociables, disparadores de escalada, una jerarquía remedial, salida por niveles y criterios de aprobación explícitos) está adaptado de una revisión agresiva de calidad de código.

Para el catálogo completo de reglas (curvas de easing, tablas de duración, configuración de springs, gestos, clip-path, rendimiento, accesibilidad), consulta STANDARDS.md. Cárgalo siempre que un hallazgo necesite un valor o una cita precisos.

Los Diez Estándares No Negociables

Cada animación en el diff se mide contra estos. Una violación es un hallazgo.

  1. Motion justificado. Cada animación debe responder "¿por qué anima esto?" — coherencia espacial, indicación de estado, retroalimentación, explicación, o prevención de un cambio brusco. "Se ve genial" en un elemento que se ve con frecuencia es un bloqueo.

  2. Apropiado a la frecuencia. Iguala el motion a la frecuencia con la que se ve. Las acciones iniciadas por teclado y las de 100+/día no tienen animación. Decenas/día obtienen motion reducido. Ocasional obtiene estándar. Raro/primera vez puede tener deleite.

  3. Easing receptivo. Los elementos que entran/salen usan ease-out o una curva personalizada fuerte. ease-in en UI es un bloqueo: retrasa el momento que el usuario más mira. Los easings CSS incorporados son demasiado débiles; espera cubic-beziers personalizados.

  4. UI por debajo de 300ms. Las animaciones de UI se mantienen por debajo de 300ms; cualquier cosa más lenta en un elemento de UI necesita justificación o es un hallazgo. Los presupuestos por elemento residen en STANDARDS.md.

  5. Origen y corrección física. Los popovers/desplegables/tooltips escalan desde su disparador (transform-origin), no desde el centro. Nunca animar desde scale(0) — comenzar desde scale(0.9–0.97) + opacidad (Los modales están exentos — permanecen centrados).

  6. Capacidad de interrupción. El motion disparado rápidamente o impulsado por gestos (toasts, alternadores, arrastres) debe ser interrumpible — transiciones CSS o springs que redireccionan desde el estado actual, no keyframes que reinician desde cero.

  7. Propiedades solo GPU. Animar solo transform y opacity. Animar width/height/margin/padding/top/left (o abreviaturas de Framer Motion x/y/scale bajo carga) es un hallazgo de rendimiento.

  8. Accesibilidad. Se respeta prefers-reduced-motion (más suave, no cero — mantener opacidad/color, eliminar movimiento). Las animaciones al pasar el ratón están protegidas por @media (hover: hover) and (pointer: fine).

  9. Entrada/salida asimétrica. Las acciones deliberadas (una pulsación, una retención, una confirmación destructiva) animan más lento; las respuestas del sistema son rápidas. La sincronización simétrica en una interacción de presionar y soltar o mantener es un hallazgo.

  10. Cohesión. El motion coincide con la personalidad del componente y el resto del producto — lo lúdico puede ser más rebotante, un panel permanece nítido. Una personalidad no coincidente, o un crossfade brusco donde un sutil desenfoque uniría dos estados, es un hallazgo. Cuando no estés seguro de si el motion se siente correcto, el movimiento más fuerte es a menudo eliminarlo.

Disparadores de Escalada Agresivos

Marca estos a la vista, sin piedad:

  • transition: all (animación de propiedades sin límites)
  • scale(0) o entradas de solo desvanecimiento sin transformación inicial
  • ease-in en cualquier interacción de UI; easing incorporado débil en una animación deliberada
  • Animación en un atajo de teclado, alternancia de paleta de comandos, o acción de 100+/día
  • Duración de UI > 300ms sin razón declarada
  • transform-origin: center en un popover/desplegable/tooltip anclado a un disparador
  • Keyframes en toasts, alternadores, o cualquier cosa añadida/disparada rápidamente
  • Animar propiedades de layout (width/height/margin/padding/top/left)
  • Props de Framer Motion x/y/scale en motion que se ejecuta mientras la página está ocupada
  • Actualizar una variable CSS en un padre para impulsar una transformación de hijo (tormenta de recálculo de estilos)
  • Falta de manejo de prefers-reduced-motion en movimiento
  • Motion :hover sin protección
  • Sincronización simétrica de entrada/salida en una interacción de presionar y soltar o mantener
  • Entrada de todo a la vez donde un escalonamiento de 30–80ms corresponde

Jerarquía de Preferencia Remedial

Al proponer correcciones, prefiere los movimientos anteriores sobre los posteriores:

  1. Eliminar la animación (alta frecuencia / sin propósito / disparada por teclado).
  2. Reducirla — duración más corta, transformación más pequeña, menos propiedades animadas.
  3. Corregir el easing — cambiar ease-in→ease-out/curva personalizada; usar un cubic-bezier fuerte.
  4. Corregir el origen/fisicalidad — corregir transform-origin; reemplazar scale(0) con scale(0.95)+opacidad.
  5. Hacerla interrumpible — keyframes → transiciones, o un spring para motion impulsado por gestos.
  6. Moverla a la GPU — props de layout → transform/opacity; abreviatura → cadena transform completa; WAAPI para CSS programático.
  7. Temporización asimétrica — ralentizar la fase deliberada, acelerar la respuesta.
  8. Pulir — desenfoque para enmascarar crossfades, escalonamiento para grupos, @starting-style para entrada, spring para elementos "vivos".
  9. Accesibilidad y cohesión — agregar protección de motion reducido + hover; ajustar para que coincida con la personalidad del componente.

Formato de Salida Requerido

Dos partes, en este orden.

Parte 1 — Tabla de hallazgos (OBLIGATORIO)

Una sola tabla markdown. Una fila por problema. Nunca una lista "Antes:/Después:".

AntesDespuésPor qué
transition: all 300mstransition: transform 200ms ease-outEspecificar propiedades exactas; all anima propiedades no intencionadas fuera de GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nada aparece de la nada — scale(0) parece que vino de la nada
ease-in en desplegableease-out + curva personalizadaease-in retrasa el momento que el usuario más mira; se siente lento
transform-origin: center en popovervar(--transform-origin) (Base UI)Los popovers escalan desde su disparador, no desde el centro (los modales están exentos)

Parte 2 — Veredicto (OBLIGATORIO)

Agrupa los comentarios restantes por nivel de impacto, el más alto primero. Omite niveles vacíos.

  1. Regresiones que rompen la sensación — easing lento, viene de la nada, se dispara en acciones de alta frecuencia/teclado.
  2. Simplificaciones perdidas — animaciones que deberían eliminarse o reducirse drásticamente.
  3. Rendimiento — propiedades no GPU, riesgos de pérdida de frames, tormentas de recálculo.
  4. Capacidad de interrupción y temporización — keyframes donde corresponden transiciones/springs; sincronización simétrica que debería ser asimétrica.
  5. Origen, fisicalidad y cohesión — origen incorrecto, personalidad no coincidente, crossfades bruscos.
  6. Accesibilidad — protección de motion reducido y puntero/hover.

Cierra con una decisión explícita:

  • Bloquear — cualquier regresión que rompa la sensación, animación en una acción de teclado/alta frecuencia, scale(0)/ease-in en UI, o una animación no GPU con una corrección GPU fácil.
  • Aprobar — sin regresiones que rompan la sensación, sin motion obvio que deba eliminarse, duraciones y easing dentro de los límites, capacidad de interrupción manejada donde sea necesario, motion reducido respetado.

Sé específico y cita archivo:línea. Cuando se necesite un valor (una curva, una duración, una configuración de spring), extrae el exacto de STANDARDS.md en lugar de aproximarlo.

Directrices

  • Prefiere transiciones CSS/@starting-style/WAAPI para motion predeterminado; JS/springs para motion dinámico, interrumpible e impulsado por gestos.
  • Cuando no estés seguro de si el motion se siente correcto, recomienda revisarlo en cámara lenta / fotograma a fotograma y con ojos frescos al día siguiente en lugar de adivinar.

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

Skills relacionados