Communitygithub.com

aktiva-labs/Claude-Skill-Compendium

Construye animaciones en React Native y Expo, tomando las decisiones en el orden que determina si se sienten correctas: si debe animar, en qué hilo se ejecuta, qué propiedades, spring o timing, cómo se transfiere el gesto, cómo degrada. Escribe la implementación con Reanimated, Gesture Handler, Expo Router y expo-haptics. Úsalo al animar cualquier cosa en una app Expo, agregar gestos, hojas, transiciones de pantalla, retroalimentación de presión o hápticos, o al corregir movimiento que entrecorta en el dispositivo. Para animación web usa `animate`.

¿Qué es Claude-Skill-Compendium?

Esta habilidad está diseñada para desarrolladores que crean animaciones en React Native y Expo con un enfoque en el rendimiento en dispositivos reales, basándose en la filosofía del desarrollador de animación Emil Kowalski. Te guía a través de una secuencia de decisiones clave: primero, determinar si algo necesita animación; segundo, identificar su propósito; tercero, seleccionar la herramienta más simple y eficaz (como transiciones CSS de Reanimated, valores compartidos o animaciones de diseño); cuarto, elegir las propiedades correctas (priorizando transform y opacidad); quinto, decidir entre spring o timing; y sexto, garantizar que la animación no bloquee el hilo de JavaScript. La habilidad también cubre prácticas esenciales como reemplazar los estados de hover con retroalimentación táctil (presión, escala), integrar hápticos de manera juiciosa, y manejar correctamente el modo de movimiento reducido y la accesibilidad. Admite plataformas React Native (Expo) y utiliza paquetes como `react-native-reanimated`, `react-native-gesture-handler`, `expo-router` y `expo-haptics`. Su fortaleza está en evitar errores comunes que causan tartamudeo, como animar propiedades que fuerzan un recálculo de layout o usar `useNativeDriver` incorrectamente.

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

Preguntar en tu IA favorita

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

Documentación

Creando Animaciones en Expo

Respuesta Inicial

Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde únicamente con:

Estoy listo para construir animaciones en Expo y React Native que se sientan correctas en un dispositivo real, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Una habilidad de construcción para React Native. Convierte una solicitud de movimiento en una implementación que sobrevive a una revisión estricta en un dispositivo real, no en el simulador, no en un teléfono insignia en modo de desarrollo.

El móvil cambia tres cosas sobre la animación, y todo en esta habilidad se deriva de ellas:

  1. No hay hover. Cada recurso que la web pone en hover tiene que vivir en la presión, la posición o nada.
  2. Hay dos runtimes. Worklets (Reanimated 4) lo hace explícito: el runtime de React Native, donde React renderiza y tu lógica de aplicación se ejecuta, y el runtime de UI, donde los worklets se ejecutan en cada fotograma (además de runtimes worker opcionales para trabajo en segundo plano). Una animación que toca el runtime de RN entrecorta en el momento en que la aplicación hace cualquier otra cosa. Todo el arte consiste en mantener el movimiento en el runtime de UI.
  3. El dedo del usuario está sobre el elemento. Los gestos son la entrada principal, por lo que la capacidad de interrupción y la transferencia de velocidad no son un lujo, son la línea base.

Postura Operativa

Eres un ingeniero móvil senior que construye la animación tú mismo. Toma la decisión, indica el razonamiento en una línea, escribe el código. Nunca presentes opciones de movimiento como un menú.

Dos modos de fallo, y el primero es peor:

  1. Animar algo que no debería animarse. La compuerta de abajo existe para producir cero líneas de código a veces.
  2. Animar lo correcto en el hilo incorrecto — un setState por fotograma, un PanResponder, un height animado. Se ve bien en desarrollo en tu teléfono y baja a 20fps en un Android de tres años.

Reglas Estrictas

  1. Ejecuta la secuencia en orden. Los pasos 1 y 2 lo compuertan todo.
  2. Reanimated, no el Animated central. El Animated central no puede ser impulsado por un gesto sin cruzar el puente, y useNativeDriver rechaza cualquier cosa que no sea transform y opacidad. Los worklets de Reanimated se ejecutan en el hilo de UI y siguen ejecutándose mientras JS está ocupado.
  3. Sin valores aproximados. Las curvas y configuraciones de spring provienen de las tablas de abajo.
  4. El movimiento reducido se envía con la animación, no como seguimiento.
  5. La sensación se juzga en una compilación de release en el dispositivo más lento que soportes. Nada más cuenta como verificado.

La Secuencia de Construcción

1. ¿Debería animarse esto?

FrecuenciaDecisión
100+ veces/día — cambios de pestaña, apertura/cierre de teclado, desplazamiento, alternancias en ajustesSin animación. Valor por defecto de la plataforma o nada. Detente aquí.
Decenas de veces/día — retroalimentación de presión, navegación de lista, selección de filaCasi imperceptible solamente: menos de 150ms, o nada
Ocasional — hojas, modales, toasts, pasos de incorporaciónAnimación estándar
Raro / primera vez — estados de éxito, ilustraciones de vacío, celebraciónEl presupuesto de deleite vive aquí

Los cambios de pestaña nunca se deslizan. Las pestañas son pares, no una jerarquía; deslizar implica una profundidad que no existe, y el usuario lo paga decenas de veces por sesión. animation: 'none'.

Si la solicitud falla esta compuerta, dilo y no la escribas.

2. ¿Cuál es el propósito?

Nómbralo en una palabra antes de continuar: retroalimentación, consistencia espacial, indicación de estado, evitar un cambio brusco, explicación o deleite (solo nivel raro).

¿No puedes nombrarlo? No lo construyas.

3. Elige la herramienta — la más barata que funcione

Recorre hacia abajo; detente en la primera que encaje.

NecesidadHerramienta
Un cambio impulsado por estado sin gestos — presión, alternancia, color, un valor que cambiaTransición CSS de Reanimated (transitionProperty en el estilo)
Bucle, multi-etapa, o se reproduce al montar sin cambio de estadoAnimación CSS de Reanimated (animationName keyframes)
Un elemento montándose o desmontándose, o una lista reordenándoseAnimaciones de diseño (entering / exiting / itemLayoutAnimation)
Cualquier cosa que un dedo toque, o cualquier cosa derivada del desplazamientouseSharedValue + Gesture + useAnimatedStyle
Pantalla a pantallaOpciones de stack nativas en Expo Router. Nunca lo hagas manualmente
Una hoja inferior que es su propia pantallapresentation: 'formSheet' — es un UISheetPresentationController real, gratuito y correcto
Barra de pestañasNativeTabs (de expo-router/unstable-native-tabs) — la barra de pestañas real de la plataforma, sus comportamientos y transiciones incluidos
Menú contextual, vista previa de mantener presionadoLink.Menu / Link.Preview (Expo Router, solo iOS) — menús y vistas previas nativos, nunca reconstruidos en JS
Encabezado que se colapsa en un título grandeheaderLargeTitleEnabled en el stack nativo (solo iOS; headerLargeTitle está obsoleto) — no un worklet de scroll
Desplazar para actualizarRefreshControl — manual solo cuando es una interacción característica (ver la receta de umbral)
UI que sigue al tecladoreact-native-keyboard-controller — la posición real del teclado, fotograma a fotograma, en el hilo de UI
Ilustración vectorial, celebración, estado vacíoLottie — solo para ilustración, nunca para estado de UI
Una escena animada enorme, dibujo libre@shopify/react-native-skia — un lienzo, para cuando la jerarquía de vistas en sí misma es el cuello de botella

Recurre a un valor compartido solo cuando el valor es continuo o interrumpible. Una escala de presión es una transición CSS; un arrastre es un valor compartido. Usar un worklet para una alternancia de dos estados es el equivalente móvil de instalar una biblioteca de movimiento para un desvanecimiento.

Dependencias. Instala con npx expo install <package> — resuelve la versión que coincide con el SDK del proyecto, que npm install simple no hará:

NecesidadPaquete
Animaciónreact-native-reanimated + react-native-worklets
Gestosreact-native-gesture-handler
Navegación, hojas, pestañas nativas, menúsexpo-router
Hápticosexpo-haptics
UI que sigue al tecladoreact-native-keyboard-controller (necesita KeyboardProvider en la raíz — ver la receta de teclado)
Ilustración, celebraciónlottie-react-native
Escenas animadas muy grandes, dibujo personalizado@shopify/react-native-skia

4. Elige las propiedades

  • transform y opacity son gratis. Todo lo demás es un pase de layout. width, height, margin, padding, flex, top, left, gap vuelven a ejecutar Yoga en cada fotograma para ese nodo y sus hermanos.
  • La única excepción: un elemento posicionado absolutamente sin hijos — una pastilla de pestaña, un relleno de barra de progreso. Está fuera del flujo, por lo que nada más se re-layout, y animar width mantiene el radio de esquina que scaleX mancharía.
  • Nunca scale(0). Comienza desde scale(0.9–0.97) + opacity: 0. Nada en el mundo real aparece de la nada.
  • transform es un array y el orden importa — [{ translateY }, { scale }] escala después de moverse; invertido, la traslación también se escala. Mantén translate primero a menos que quieras la multiplicación.
  • Las sombras en Android son elevation, y animar elevation re-renderiza la sombra en cada fotograma. Anima la opacidad de una capa con sombra pre-dibujada en su lugar.
  • Nunca animes la intensidad de BlurView. En Android re-renderiza el desenfoque en cada fotograma. Haz una transición cruzada de la opacidad de un BlurView estático en su lugar.
  • Los porcentajes funcionan en translate y son relativos al tamaño del propio elemento — translateY('100%') mueve una hoja por su propia altura independientemente de su contenido.

5. ¿Timing o spring?

Si un dedo estuvo involucrado, usa spring. Los springs llevan la velocidad a través de una interrupción; las curvas de timing se reinician. Todo lo demás usa timing.

El spring de Reanimated toma directamente los dos parámetros de diseño de Apple — usa esta forma, no masa/rigidez/amortiguación:

InteracciónConfig
Asentamiento por defecto, sin sobreimpulso{ duration: 400, dampingRatio: 1 }
Reposicionar / volver a su lugar después de un arrastre{ duration: 400, dampingRatio: 0.8, velocity }
Hoja, cajón{ duration: 300, dampingRatio: 0.8, velocity }
No debe pasar un borde duroagregar overshootClamping: true

Rebote solo cuando el gesto llevaba impulso. El sobreimpulso en un menú que apareció con desvanecimiento se siente incorrecto; el sobreimpulso en una tarjeta que lanzaste se siente correcto.

Atenuación, para todo sin un dedo sobre ello:

SituaciónAtenuación
Entrando o saliendoease-out
Moviéndose / transformándose en pantallaease-in-out
Movimiento constante (progreso, marquesina)linear
Por defectoease-out

Nunca ease-in en UI. Comienza lento, retrasando el momento exacto que el usuario está mirando. Los incorporados de Reanimated son tan débiles como los de CSS — usa estos:

import { Easing } from 'react-native-reanimated';

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // ease-out fuerte para UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // movimiento en pantalla
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // curva de hoja de iOS

Duración:

ElementoDuración
Retroalimentación de presión100–150ms
Alternancia, chip, cambio de estado pequeño150–200ms
Hoja, modal, cajónspring, ~300ms percibidos
Transición de pantallael valor por defecto de la plataforma — no lo sobrescribas

Las animaciones de UI móvil se mantienen por debajo de 300ms, igual que en la web. Las transiciones propias de la plataforma son más largas (el push de iOS es 350ms); iguala la plataforma para la navegación, supérala en todos los demás lugares.

6. Mantenlo fuera del hilo JS

Este es el arte específico del móvil, y es donde la mayoría del movimiento de React Native muere.

  • Nunca setState desde un manejador de gestos o scroll. Un render de React por fotograma es la causa individual más grande de tartamudeo en apps RN. Valor compartido → useAnimatedStyle, y React nunca vuelve a renderizar en absoluto.
  • Nunca programes un retorno al runtime de RN dentro de onUpdate o un manejador de scroll. scheduleOnRN(fn, ...args) de react-native-worklets — el reemplazo de Reanimated 4 para el obsoleto runOnJS(fn)(...args) — pone en cola una llamada al runtime de RN, y en onUpdate eso es de 60 a 120 veces por segundo. Pertenece en onEnd, o en un useAnimatedReaction que se dispara cuando un valor cruza un umbral.
  • Nunca leas un valor compartido durante el render (translateY.get() en JSX). Es una instantánea que nunca se actualiza y se desincroniza silenciosamente. Tampoco escribas uno durante el render — se dispara en medio de la reconciliación, y un re-render que no causaste reproduce la escritura. Toca los valores compartidos solo en worklets, manejadores y efectos.
  • Usa .get() / .set(), no .value. La misma API, pero el acceso directo a .value es la forma que el React Compiler no puede ver — los docs de Reanimated llaman a get/set la forma segura para el compilador. set también toma una actualización funcional: sv.set((v) => v + 1).
  • Las funciones llamadas desde un worklet necesitan 'worklet' como su primera línea, o lanzan un error en tiempo de ejecución en el dispositivo mientras funcionan bien en el depurador.

7. Presión, no hover

Cada recurso de hover de la web tiene que ser rediseñado, no portado.

  • Retroalimentación al presionar, confirmación al soltar. Esperar a que el toque se complete antes de mostrar cualquier cosa se siente muerto — esta es la latencia que el usuario realmente percibe.
  • scale: 0.97 en 100–150ms en cualquier elemento presionable, Pressable + una transición CSS. scale lleva consigo la etiqueta y los iconos, que es lo que hace que se lea como físico.
  • Objetivo táctil mínimo de 44×44pt (48dp Android). Si lo visual es más pequeño, agrega hitSlop — no agrandes lo visual.
  • pressRetentionOffset para que un dedo que se desvía unos pocos píxeles no cancele una presión que el usuario pretendía.
  • Ondulación de Android solo en una app con estilo Material. En una app con diseño personalizado, la misma escala en ambas plataformas es más coherente que una ondulación en una.

8. Hápticos

El móvil tiene un sentido que la web no tiene. Úsalo con moderación y se convierte en lo que hace que la aplicación se sienta costosa; úsalo en todas partes y los usuarios lo apagan.

MomentoLlamada
Un valor pasa un paso — selector, trinquete de slider, control segmentadoHaptics.selectionAsync()
Algo encaja en su lugar, un trinquete de hoja atrapa, un arrastre se confirmaHaptics.impactAsync(ImpactFeedbackStyle.Light)
Un objeto pesado aterriza, una acción destructiva se disparaHaptics.impactAsync(ImpactFeedbackStyle.Medium)
Operación exitosa o fallidaHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

Tres reglas, y son absolutas:

  • Mismo fotograma que lo visual. Un háptico que se retrasa con respecto a su animación se lee como un error, no como retroalimentación. Dispara en el momento causal — el trinquete atrapando — no cuando la animación termina.
  • Uno por acción del usuario. Nunca en desplazamiento, nunca por fotograma, nunca en una animación de entrada que el usuario no causó.
  • Nunca la única retroalimentación. Los hápticos están apagados a nivel de sistema para muchos usuarios, y silenciosos en la mayoría del hardware Android. Lo visual tiene que ser independiente.

Desde un worklet, los hápticos deben ser programados de vuelta al runtime de RN: scheduleOnRN(Haptics.selectionAsync).

9. Movimiento reducido y accesibilidad

import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';

const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);

// o deja que cada animación decida
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

Movimiento reducido significa menos y más suave, no cero: mantén los cambios de opacidad y color que explican un cambio de estado, elimina la traslación, escala, paralaje y sobreimpulso. Las transiciones de pantalla se convierten en animation: 'fade'.

Escalado de texto. allowFontScaling está activado por defecto, por lo que cualquier altura que mediste con el tamaño de tipo por defecto está incorrecta al 200%. Nunca animes a una altura fija — mide con onLayout, o anima una transformación en su lugar.

Configuración que rompe el movimiento silenciosamente

Revisa esto primero cuando "la animación simplemente no se ejecuta":

  • Instala a través de Expo para que las versiones coincidan con el SDK: npx expo install react-native-reanimated react-native-worklets. En un proyecto Expo, babel-preset-expo configura automáticamente el plugin de Babel de worklets — no hay paso de babel.config.js. Solo un proyecto RN puro sin ese preset agrega el plugin manualmente, y

...

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

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.

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.

Skills relacionados