Communitygithub.com

ayangabryl/seenry-skills

Construye, revisa o investiga animaciones de interfaz: feedback de presión, menús, tooltips, diálogos, hojas, toasts, acordeones, pestañas, transiciones de página y elementos compartidos, efectos de scroll, arrastre y gestos, cambios de número e icono. Decide si algo debe animarse, luego elige la herramienta, propiedades, curva, duración o muelle, interrupción y comportamiento de movimiento reducido, con recetas de CSS moderno probadas y assets ejecutables. También estudia movimientos grabados de referencias Seenry.

¿Qué es seenry-skills?

Esta skill está diseñada para guiar a un agente de IA o desarrollador en la creación de animaciones de interfaz precisas y eficientes. Su propósito principal es decidir si una animación es necesaria y, en caso afirmativo, seleccionar la herramienta y configuración más adecuadas, priorizando la funcionalidad sobre la estética. La skill sigue una secuencia de construcción que comienza evaluando la frecuencia de uso del elemento para determinar si debe animarse, y luego define el propósito, la herramienta, las propiedades CSS, la curva de aceleración y la duración. También incluye pautas para manejar interrupciones, estados de movimiento reducido y accesibilidad, asegurando que las animaciones expliquen cambios en la interfaz sin afectar el rendimiento o la usabilidad. Está diseñada para plataformas como Claude Code, Cursor, Codex y otras herramientas de desarrollo, y se basa en recetas de CSS moderno probadas en Chromium, así como en referencias de animación de Seenry. La skill enfatiza la reutilización de tokens y componentes de movimiento existentes del proyecto, evitando añadir conjuntos paralelos de estilos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ayangabryl/seenry-skills/tree/HEAD/skills/seenry-motion

Preguntar en tu IA favorita

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

Documentación

Seenry Motion

El movimiento existe para explicar un cambio: de dónde vino algo, qué hizo la entrada, en qué estado se encuentra la interfaz ahora. Construye cada animación siguiendo la secuencia a continuación, en orden; los pasos 1 y 2 deciden si se escribe algún código.

Toma la decisión y exprésala en una línea; no ofrezcas un menú de opciones de movimiento. Extiende los tokens y componentes de movimiento existentes del proyecto en lugar de añadir un conjunto paralelo.

La secuencia de construcción

1. ¿Debería animarse? Decide según la frecuencia.

Con qué frecuencia lo ve la genteDecisión
100+ veces al día (menú de comandos, atajos de teclado, navegación de lista con flechas)Sin animación. Instantáneo.
Decenas de veces al día (hover, pestañas, interruptores)≤150ms en opacidad y color solo, o nada
Ocasionalmente (menús, diálogos, hojas, toasts)Movimiento estándar de la tabla a continuación
Raramente (onboarding, primer éxito, momentos de vacío a lleno)Espacio para el carácter

Las acciones activadas por teclado nunca esperan animación. Si la compuerta dice que no, dilo y envía el cambio de estado instantáneo.

2. Nombra el propósito en una palabra: retroalimentación, orientación (de dónde vino o a dónde fue), estado, continuidad (evitar un salto brusco), explicación (solo marketing y onboarding) o deleite (solo momentos raros). Sin propósito, sin animación. Los datos que la gente está leyendo nunca se mueven por estilo.

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

NecesidadHerramienta
Hover, presión, color, cambio de clase o atributoCSS transition
Entrada al montar, salida antes de display: none, <dialog> nativo y popoverCSS transition + @starting-style + allow-discrete
Altura a autointerpolate-size: allow-keywords, o la pista de grid 0fr → 1fr
Cambios de ruta, lista → detalle, indicadores de morfismoView Transitions API
Efectos vinculados al scrollanimation-timeline: view() / scroll()
Programático, cancelable, sin libreríaWeb Animations (element.animate)
Muelles con velocidad, animación de diseño, gestos, presencia en ReactMotion (motion.dev)
Un componente completo (toast, cajón, menú de comandos, select)Una librería mantenida, ver librerías

4. Elige las propiedades. Solo translate, scale, rotate, opacity, clip-path, filter. Nunca entres desde scale(0): comienza en 0.95–0.97 con opacidad 0. Los popovers escalan desde su desencadenante (transform-origin en el lado del desencadenante); los diálogos escalan desde el centro. Los porcentajes de traducción (translate: 0 100%) se mueven por el tamaño propio del elemento.

5. Elige la curva y la duración, o un muelle.

MovimientoDuraciónAceleración
Retroalimentación de presión100–160ms--ease-out
Tooltip, popover pequeño120–200ms--ease-out
Menú, desplegable, select150–250ms--ease-out
Diálogo200–250ms--ease-out
Hoja, cajón350–500ms--ease-drawer
Elemento moviéndose por la pantalla, morfismos250–400ms--ease-in-out
Color, fondo, borde en hover150msease
Progreso, marquee, relleno de confirmación sostenidamientras dure el trabajolinear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). Nunca uses ease-in en movimiento de interfaz: retrasa exactamente el momento que la gente está viendo. Prefiere UI de producto por debajo de 300ms; un recorrido más largo de hoja necesita una razón. Las salidas suelen ser ~20–30% más rápidas que las entradas, a menos que preservar una relación de manipulación directa o espacial justifique el mismo tiempo. Usa un muelle para cualquier cosa que el usuario arrastre, lance o pueda revertir a medio camino: Motion {type: "spring", duration: 0.5, bounce: 0.2} (bounce 0 para UI de producto, ≤0.3 para juguetón), o los muelles CSS linear() en recetas.

6. Planifica la interrupción y la salida. Prefiere transiciones CSS para cambios de propiedades reversibles porque reorientan desde el valor actual. Cuando la geometría o coreografía necesite WAAPI, captura el estado renderizado actual, cancela o reorienta las animaciones propias, y protege la finalización obsoleta. Una segunda entrada invierte o reemplaza la solicitud anterior en lugar de encolarse detrás de ella. Publica el nuevo estado lógico inmediatamente; un estado de presentación separado puede mantener una salida pintada.

Refina el cambio interrumpido. Usa estas comprobaciones donde encajen en el componente. Son heurísticas de diseño, no una puntuación de juez garantizada. Prueba entradas repetidas durante la entrada y salida, incluyendo con 50–150ms de separación; registra los tiempos reales al hacer afirmaciones de tiempo.

  • Mantén la continuidad y la semántica. Pestañas, filtros o estados de estado relacionados pueden compartir una celda de grid (display:grid, grid-area:1/1) y transicionar opacidad o una pequeña traducción. Mantén el contenido inactivo fuera del orden de enfoque y del árbol de accesibilidad; montado no significa interactivo. Una fase de salida rápida (aproximadamente 65–90ms) y una de entrada de 120–160ms pueden ser un punto de partida, no una receta obligatoria. Desmonta u oculta solo cuando la transición actual lo permita; una finalización obsoleta nunca debe ocultar un estado más nuevo. Las salidas de WAAPI explícitamente cancelables y las salidas de diálogo nativo protegidas son alternativas válidas.
  • Mantén el resultado comprensible. Evita intervalos en blanco accidentales o texto competitivo ilegible. Elige superposición, un crossfade corto o un reemplazo instantáneo según el contenido; un desvanecimiento completo de la etiqueta puede ser más seguro que mover texto a través del arte. Preserva una señal estática apropiada mientras el movimiento no está disponible o está reducido. Inspecciona la legibilidad real en lugar de usar un umbral de opacidad como prueba.
  • Una sola copia de una cosa que viaja. Cuando un título, avatar o portada se mueve a un nuevo lugar, evita pintura duplicada visible. Oculta el destino hasta que el viajero llegue, luego retira la copia temporal. Traza el texto contra el arte y el shell en movimiento; un punto final sin recortar no prueba un camino legible.
  • La etiqueta coincide con su resultado. Una etiqueta como "Marcar como pagado" que se convierte en "Pagado" sigue el mismo estado de aplicación aceptado que su resultado. Reserva su espacio cuando sea útil y evita texto obsoleto o etiquetas duplicadas enfocables. No retrases un estado de éxito real solo para terminar la decoración.
  • Las secuencias pueden cancelarse. Las demostraciones de escritura, las revelaciones por etapas y las repeticiones comparten un propietario para los pasos pendientes. La pausa, la reversión y la nueva entrada cancelan el trabajo obsoleto y reorientan el movimiento visible desde su estado actual. Un timeout obsoleto no debe reanudar una secuencia pausada ni sobrescribir contenido más nuevo.
  • Libera las animaciones terminadas. Establece el estado final mediante CSS o estilos comprometidos, luego libera las animaciones WAAPI finitas propias cuando sea apropiado. fill:forwards no debe seguir sobrescribiendo cambios de estado posteriores. Verifica que no haya animaciones inesperadas después de que la interacción se estabilice, permitiendo al mismo tiempo un indicador de carga intencional hasta que termine su trabajo.
  • Cada movimiento explica una relación. Los menús crecen desde su desencadenante, los paneles desde su borde, y el contenido relacionado se mueve de forma consistente con la navegación. Usa los rangos de duración anteriores como puntos de partida; mantén la respuesta percibida inmediata y justifica los recorridos más largos. Prueba la interrupción y el movimiento reducido en lugar de tratar una duración fija como prueba de calidad.

Alcanzando el 9. En el juez de movimiento, 7 es correcto pero genérico, 8 es claramente premium y 9 es distintivo al nivel de Apple o Linear. Las rondas se estancan en 7–8 por las mismas pocas razones. Maneja todas ellas antes de gastar una ejecución:

  • Un componente a la vez. Juzga cada componente por separado con --labels "<Row>" hasta que puntúe 9, y mantén la mejor versión de cada uno. El puntaje general de un catálogo sigue a sus filas más débiles, así que parchear muchas filas a la vez nunca lo mueve, y un cambio que baja una fila se revierte incluso si el juez lo sugirió.
  • Aplica cada corrección, no solo la principal. Los elementos pequeños que se repiten (retroalimentación de hover, presión y control de cierre) mantienen states en 7 ronda tras ronda. --prev <last motion.json> enumera los criterios que no subieron y las interacciones que se pidió arreglar de nuevo; check.mjs lo pasa automáticamente.
  • Un problema que vuelve después de su corrección es estructural. Reajustar el tiempo no puede arreglar un camino que se cruza. Los elementos compartidos mantienen su disposición relativa entre estados: un título debajo de su portada permanece debajo en la vista detallada, así que ninguno pasa a través del otro.
  • Sin fotogramas vacíos. En cada momento filmado (30–320ms) la región cambiada muestra contenido real. Un shell lleva su contenido mientras crece; una respuesta en streaming crece desde sus primeras palabras. Nunca muestres un cuadro de respuesta en blanco o un esqueleto que espera y luego se disuelve.
  • Una idea elaborada por componente. Lo que persiste viaja y lo que es nuevo nace de su causa. Un desvanecimiento, una traducción de 4px y un intercambio de etiqueta puntúan 7.
  • Cierra donde se abrió. Una superficie que se abre desde un control se cierra desde el mismo punto: el control se convierte (o se reemplaza en su lugar) por su cierre, para que la mano nunca viaje. No necesita mantener el mismo color; mantiene el lugar y el tamaño.
  • Una sola ejecución no es una puntuación. Una ejecución del juez (en sí misma una mediana de tres) se mueve un punto en código sin cambios. Acepta un 9 solo cuando dos ejecuciones separadas lo alcancen, y compara versiones en el mismo número de ejecuciones.

7. Entrega movimiento reducido y bloqueo de entrada con él. Bajo prefers-reduced-motion: reduce, elimina movimiento, paralaje, desenfoque y bucles; mantén cambios cortos de opacidad que ayuden a la comprensión. Bloquea el movimiento de hover con @media (hover: hover) and (pointer: fine). Cada cambio de estado animado también deja una señal estática (etiqueta, icono, color) para cuando el movimiento no se ejecute.

Recetas

Empieza desde recetas para retroalimentación de presión, menús y popovers, tooltips, diálogos, hojas, toasts, acordeones, entradas escalonadas, indicadores de pestañas, transiciones de página y elementos compartidos, revelaciones de scroll, intercambios de iconos, cambios de número, confirmación sostenida, arrastre para descartar (con proyección de velocidad y efecto elástico), enmascaramiento de crossfade, cambio de tema y supresión de primer renderizado. Las recetas nativas de CSS se prueban en Chromium mediante las pruebas del paquete.

Assets ejecutables

Cambio solicitadoRuta enfocada
Menú de acción o etiqueta de estado cortaOriginal menú de acción, interruptor de estado y transiciones de producto. Si se pide que el menú se anime al abrir y cerrar, preserva su superficie durante la fase de cierre; el desmontaje condicional al cerrar salta esa fase. Para una transición de estado, mueve el texto en una ranura reservada; un reemplazo de texto simple o cambio de color de punto solo es incompleto. La aplicación posee la acción real.
Divulgación en flujo o geometría cambianteOriginal tarjeta expansible, ayudante de geometría y patrones de superficie. Preserva el enfoque y reorienta desde la geometría actual.
Tarea modal enfocadaOriginal superficie modal y patrones de superficie. Usa un diálogo nativo para el comportamiento de capa superior y enfoque; permite que la salida termine antes de cerrar, y haz que la reversión cancele el cierre pendiente.
Cambio de número o iconoTransiciones de número y adaptadores. Para un recuento de enteros pequeño, prefiere el ayudante de recuento pop original sobre reconstruir la semántica de dígitos. Mantén un valor accesible real; no ocultes cada dígito y pongas aria-label en un <strong> simple. Una transición de dígitos necesita movimiento por lugar; mantén las unidades ancladas.
Entrada o salida de voz en vivoOriginal presencia de voz acepta estado propiedad de la aplicación y un nivel de audio normalizado. Mantén los controles y anuncios en el DOM; una señal de demostración generada no es actividad de micrófono.
Presencia de carga o procesoOriginal campo de señal, traza de límite y patrones de carga. El tiempo de animación no es progreso.
Imagen decodificada o material expresivoOriginal revelación de imagen, superficie reflectante y de borde, inclinación de puntero, efectos de superficie y efectos expresivos. Mantén contenido útil mientras se carga un reemplazo; usa reflexión e inclinación solo donde el material tenga un propósito.
Diseñar cualquier nuevo componente interactivo (brief, gráfico de estados, puntuación de movimiento, contrato de entrada, lista de verificación)Artesanía de interacción
Pila de toasts o bannersPatrones de retroalimentación y original reductor de notificaciones. Elimina el desbordamiento del estado activo antes de su salida; prueba el cuarto evento en una pila de tres elementos.
Hito completado ocasionalOriginal ráfaga de confirmación. Registra el éxito en el estado de la aplicación primero, luego reproduce la decoración finita; el resultado establecido debe permanecer visible después de que se limpie.
Pestañas seleccionadas o cambio de página ordenadoOriginal superficie de selección para un resaltado compartido y escenario direccional para vistas relacionadas; la aplicación posee selección, paneles, ruta e historial. Usa patrones de navegación para otras estructuras.
Scroll o un sistema coordinadoCoreografía de scroll, puntuaciones trabajadas, coreografía de sistema y el índice de movimiento.

Selecciona solo la guía y el ayudante necesarios para este cambio. Los assets originales incluidos son puntos de partida reutilizables, no sustitutos automáticos de un componente fuente nombrado ni prueba de fidelidad al mismo. Mantén las licencias con cualquier tiempo de ejecución de terceros copiado; los assets originales de Seenry usan la licencia MIT del repositorio.

Nunca enviar

NuncaEn su lugar
Animación en una acción de 100+/día o activada por tecladoCambio instantáneo
transition: allNombra las propiedades específicas
Animar la altura inicial desde 0 (no scale(0), height(0), width(0))Usa un enfoque de entrada escalonada o contenido real desde el inicio
Depender de un marco de trabajo para un layout CSS básicoCSS puro o un enfoque ligero
Añadir una segunda librería de animación a un proyecto que ya tiene unaUsa la existente o integra la nueva solo si es necesario y justificado

Para más detalles, consulta las referencias y assets originales en el repositorio.

Skills relacionados