Communitygithub.com

0n6k4v-Coder/skills

Traduce animaciones y transiciones de Figma a código de aplicación listo para producción. Úsalo al implementar animaciones/movimiento desde un diseño de Figma — cuando el usuario menciona "implementa este movimiento", "añade animación desde Figma", "anima este componente", proporciona una URL de Figma cuyo nodo está animado, o cuando `get_design_context` devuelve datos de movimiento o te indica que llames a `get_motion_context`.

¿Qué es skills?

Este skill guía la traducción de animaciones y transiciones de Figma a código ejecutable, utilizando motion.dev, keyframes CSS o bibliotecas específicas del framework. Se apoya en dos herramientas clave: `get_motion_context`, que proporciona el inventario completo de nodos animados, fragmentos de código precalculados y datos de keyframe de respaldo, siendo la fuente de verdad para la animación; y `get_design_context`, que ofrece la estructura estática del diseño, como diseño, dimensiones, activos, estilos y marcadores de posición de movimiento. El flujo de trabajo estándar consiste en obtener primero el contexto estático (si no está disponible), luego los datos de movimiento autorizados y, finalmente, fusionar ambos mediante el `nodeId` o el `fallbackNodeId` en caso de componentes reutilizados. El skill soporta stacks populares como React, Vue y HTML/CSS vanilla, y automatiza la aplicación de animaciones respetando el código existente. Además, maneja casos complejos como transformaciones intercaladas, animaciones de rutas SVG y grupos con `display: contents`, garantizando que la animación resultante sea precisa y esté sincronizada.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/figma/ebentley-figma/skills/figma-implement-motion

Preguntar en tu IA favorita

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

Documentación

Implementar Movimiento

Descripción General

Este skill guía la traducción de animaciones y transiciones de Figma a código ejecutable (motion.dev, keyframes CSS o bibliotecas específicas del framework).

Figma expone el movimiento a través de dos herramientas:

  • get_motion_context — herramienta autorizada de movimiento. Devuelve el inventario completo de nodos animados, fragmentos de código precalculados (CSS @keyframes + motion.dev), enlaces de keyframe de respaldo cuando los fragmentos no están disponibles y sugerencias de coordinación de línea de tiempo recursiva. Fuente de verdad para los datos de animación y qué ID de nodo animan.
  • get_design_context — la estructura del diseño: diseño, dimensiones, activos, estilos, sugerencias de Code Connect, contexto de captura de pantalla y, a veces, marcadores de colocación de movimiento en elementos animados (data-node-id, y en nodos divididos data-motion-keys / data-motion-wrapper-for / data-motion-transform-template). Puede representar un nodo animado como un elemento simple (div, p, span, etc.) o un elemento de movimiento (motion.div); no incluye los valores de animación.

Ambos están vinculados por el ID del nodo, y ese es todo el flujo de trabajo. get_motion_context te dice qué nodos animan y proporciona los valores de keyframe, easing, temporización y fragmentos. get_design_context te dice cómo se ven esos nodos y dónde están ubicados. Para cada nodo en get_motion_context.nodes, busca el data-node-id correspondiente en el contexto de diseño y fusiona el movimiento en esa estructura — añadiendo o envolviendo un motion.{tag} cuando el elemento estructural es simple. Cuando el contexto de diseño ha reutilizado un componente de Figma, el nodo de movimiento también puede incluir fallbackNodeId; úsalo solo como respaldo después de intentar con el nodeId exacto.

Límites del Skill

  • Usa este skill cuando el entregable sea código de movimiento en el repositorio del usuario.
  • Si el usuario pide crear/editar animaciones dentro de Figma, cambia a figma-use y sigue ese skill.
  • Este skill actualmente cubre animaciones tal como las emite get_motion_context (fragmentos más pistas de keyframe de respaldo, incluido el movimiento resuelto de presets en esas formas). Los flujos interactivos de variantes más amplios pueden necesitar manejo de estado específico del producto en el código.

Prerrequisitos

  • Servidor MCP de Figma conectado y accesible.
  • ID de nodo extraído de la URL de Figma que proporciona el usuario. Formato de URL: https://figma.com/design/:fileKey/:fileName?node-id=1-2 — extrae fileKey (el segmento después de /design/) y nodeId (el valor del parámetro de consulta node-id, por ejemplo 42-15).
  • Codebase de destino. El formato de salida del movimiento se adapta al stack (ver Recomendaciones de Framework).

Elección de Herramienta

Para la implementación de movimiento, usa ambas herramientas con roles distintos:

SituaciónHerramientaPor qué
Entender estructura estática, activos, estilos, Code Connect o diseño visualget_design_contextProporciona la referencia de código del componente/página y las URL de activos necesarias para colocar nodos animados correctamente.
Obtener datos de animación para cualquier nodoget_motion_contextDiseñado específicamente para movimiento y es la fuente de verdad para temporización, easing, fragmentos y keyframes.
Un nodo tiene marcadores de movimiento (data-motion-keys, data-motion-wrapper-for)Marcadores para colocación dividida, get_motion_context para valoresLos marcadores divididos te dicen qué pistas van en qué elemento; los keyframes/easing/temporización y el inventario de nodos animados provienen de get_motion_context.

get_motion_context acepta recursive: true (limitado a 500 nodos) cuando necesitas el movimiento de los descendientes en una sola llamada.

Flujo de Trabajo Requerido

Paso 1: Confirmar que el contexto de diseño estático está disponible

get_design_context(fileKey=":fileKey", nodeId="<node-id>")

Si get_design_context ya se ha llamado para este nodo, reutiliza esa salida. Si no, llámalo normalmente ahora.

Úsalo como la estructura de registro: jerarquía, dimensiones, estilos, activos, sugerencias de Code Connect, contexto de captura de pantalla y cualquier marcador de colocación de movimiento que incluya (Paso 3). El inventario de nodos animados y los valores de animación provienen de get_motion_context (Paso 2).

Paso 2: Obtener datos de movimiento autorizados

get_motion_context(fileKey=":fileKey", nodeId="<node-id>", recursive=true)

Forma de la respuesta (una entrada por nodo animado):

  • codeSnippets — cadenas de CSS @keyframes y motion.dev pregeneradas. Úsalas directamente. No las regeneres a partir de datos de keyframe de respaldo.
  • keyframeBindings — pistas de keyframe vinculadas, incluido el movimiento derivado de presets resuelto en datos de pista, incluidas solo como datos de respaldo cuando ambos formatos de fragmento faltan.
  • fallbackNodeId — ID de respaldo opcional para coincidir con el contexto de diseño componentizado. Si nodeId es un ID calificado por instancia como I4005:6111;30:8005, D2R puede renderizar el cuerpo del componente reutilizable con el ID del componente de respaldo, como 4002:3957. En ese caso, fallbackNodeId es el data-node-id a buscar si la búsqueda exacta de nodeId falla.

Las respuestas recursivas también pueden incluir timelineCohorts: grupos de ID de nodos animados que comparten una raíz de línea de tiempo, duración y modo de reproducción (once, loop o boomerang). Usa las cohortes para mantener las animaciones escalonadas o de múltiples nodos sincronizadas en lugar de inferir la temporización compartida del orden de los hermanos.

Detalles de implementación que importan para LLMs:

  • Cuando existen fragmentos, los keyframeBindings brutos, timelineDurationMs, motionSummary y el transformOrigin predeterminado pueden eliminarse para mantener el payload pequeño. La ausencia de keyframeBindings no es una señal de que no haya animación.
  • Las respuestas recursivas deduplican fragmentos duplicados exactos. Un fragmento puede reemplazarse con un comentario que apunte al primer nodo con movimiento idéntico; reutiliza el mismo componente, variante, clase o constantes en lugar de escribir una segunda animación.
  • El servidor MCP infiere fragmentos CSS vs motion.dev de clientFrameworks; si la respuesta solo contiene un formato de fragmento, adapta ese formato al stack del usuario en lugar de asumir que el otro formato falló.

Paso 3: Fusionar contexto estático y de movimiento

  • Comienza desde get_motion_context.nodes, no desde las etiquetas motion.* visibles en el JSX estático. Cada nodo devuelto está animado. Coincide cada nodo de movimiento de vuelta a get_design_context por nodeId / data-node-id exacto primero. Si y solo si no hay una coincidencia exacta, prueba con fallbackNodeId / data-node-id. Recurre al nombre/tipo de nodo y posición de captura de pantalla solo después de que ambos IDs fallen.
  • La coincidencia de ID exacto prevalece sobre fallbackNodeId. fallbackNodeId apunta al ID del componente de respaldo que D2R puede emitir dentro de un componente reutilizable. Es compartido por cada instancia de ese componente. Si el nodeId exacto existe en el contexto de diseño, aplica el movimiento allí e ignora el respaldo. Esto es crítico para la animación de instancia raíz: una instancia puede rotar o moverse de manera diferente a otra instancia del mismo componente, y aplicar ese movimiento al cuerpo del componente compartido animaría todas las instancias incorrectamente.
  • Aplica cada nodo de movimiento a la estructura de contexto de diseño coincidente, claveada por data-node-id. El data-node-id coincidente es el ancla estructural, no siempre el elemento DOM final que recibe el movimiento. Usa la forma del fragmento y los marcadores de colocación para decidir si el movimiento va en ese elemento exacto, un envoltorio, un elemento interno o una ruta SVG en línea. get_design_context ya puede emitir motion.{tag} con valores eliminados, o puede emitir un elemento estructural simple (div, p, span, raíz de componente, etc.). Si es simple y el fragmento apunta al elemento en sí, conviértelo al motion.{tag} apropiado o añade un envoltorio de movimiento preservando el texto, hijos, clases/estilos, atributos y data-node-id del nodo. Carga references/examples-and-anti-examples.md para ver ejemplos de este paso de fusión.
  • El movimiento de hijo componentizado generalmente coincide por respaldo. Cuando el contexto de diseño extrae una instancia de Figma en un componente React reutilizable, los hijos dentro del cuerpo de ese componente a menudo tienen IDs de componente de respaldo (4002:3957) mientras que el contexto de movimiento informa IDs de instancia en vivo (I4005:6111;30:8005). En este caso, usa fallbackNodeId para encontrar el data-node-id del cuerpo del componente, pero mantén el movimiento limitado a la instancia renderizada que estás implementando. Si hay múltiples instancias y solo una tiene un movimiento raíz diferente, la coincidencia exacta de ID mantiene ese movimiento por instancia separado.
  • Los nodos divididos llevan un marcador data-motion-keys / data-motion-wrapper-for — ver Manejo de transformaciones intercaladas abajo.
  • Preserva los envoltorios display: contents — a menos que el grupo mismo anime. Los envoltorios de grupo transparentes al diseño vienen como contents (Tailwind contents), generalmente junto con un absolute/inset-[…] muerto (no hacen nada en una caja contents). Para un grupo estático, mantén display: contents y deja que los hijos se posicionen contra el ancestro real más cercano — convertir el inset del envoltorio en una caja posicionada re-parenta a los hijos a una caja más pequeña, por lo que se renderizan demasiado pequeños/desplazados hacia adentro. Para un grupo animado (el nodo del grupo mismo tiene movimiento), display: contents no puede llevar una transformación — reemplázalo con un envoltorio posicionado real y aplica el movimiento del grupo allí. Carga references/gotchas.md antes de implementar este caso.
  • get_motion_context es el inventario completo de nodos animados. Algunos nodos animados se renderizan como elementos simples (no motion) — raíces de instancia de componente (<div> de posicionamiento simple), texto (<p>), máscaras — que aún llevan data-node-id. Recorre cada nodo en la respuesta de movimiento y aplica su movimiento al elemento con el data-node-id coincidente, envolviendo o convirtiendo según sea necesario. Si un nodo animado no tiene ningún elemento en la salida (por ejemplo, una máscara animada aplanada en una mask-image estática), no lo descartes silenciosamente — deja un comentario // TODO: <nodeId> movimiento no soportado y menciónalo en tu resumen.
  • Si un nodo aparece en el contexto de movimiento pero no en el JSX estático, añade el elemento necesario para representarlo — el código del contexto de diseño es una referencia, no un inventario de animación completo.
  • En caso de conflicto entre el contexto de diseño y el de movimiento (valores de temporización/easing/animados), prefiere get_motion_context.
  • Movimiento SVG a nivel de ruta: inserta el SVG en línea y anima el <path> real. Cuando get_motion_context apunta a la ruta de un vector (PATH_TRIM, motion.path, stroke-dasharray) pero el contexto de diseño lo renderiza como <img>, inserta el SVG en línea y aplica el fragmento al <path>, manteniendo el envoltorio de diseño. Carga references/svg-and-path-motion.md para el tutorial completo para este caso (motion.path, pathLength="1", envoltorio + capas de ruta, CSS path-trim).

Manejo de transformaciones intercaladas

Un nodo con una transformación base estática y transformaciones animadas se divide en elementos anidados para que ambas se compongan correctamente en lugar de competir: un motion.div sin ID que lleva data-motion-wrapper-for="<nodeId>" (el envoltorio EXTERNO) envuelve un div de transformación estática (por ejemplo, rotate-45 + dimensionamiento hypot() — o el envoltorio mismo lleva data-motion-transform-template="<css>") que envuelve el nodo INTERNO (data-node-id). Mantén el anidamiento envoltorio > div de transformación estática > interno — colapsarlo rompe el dimensionamiento y la transformación base.

  • Coloca las pistas por data-motion-keys. Las data-motion-keys del envoltorio (pistas de transformación — x/y/rotate/scaleX/scaleY/skewX) van en el envoltorio EXTERNO; las data-motion-keys del elemento interno van en el elemento INTERNO.
  • Vuelve a aplicar un data-motion-transform-template. Si el envoltorio lleva uno, establece transformTemplate={(_, generated) => "<css> " + generated} para que la transformación animada se componga sobre la transformación de diseño estática.
  • Desplaza la transformación animada por la base estática (evita la doble rotación). get_motion_context da la transformación absoluta del nodo, que ya incluye la base estática que esos divs aplican. Un fragmento rotate de [45, 125, 125] sobre una base rotate-45 significa que el envoltorio anima el desplazamiento [0, 80, 80] (= absoluto − 45), no el absoluto — de lo contrario, los 45° se aplican dos veces y el elemento se sitúa en 90° en reposo. Las pistas sin base estática (por ejemplo, x/y comenzando en 0) pasan sin cambios. Ver el ejemplo de transformación intercalada.
  • Mantén las transformaciones de diseño separadas de las transformaciones de Motion. Para cada elemento motion.* que anima rotate, scale o skew, verifica que no dependa también de transformaciones de diseño de Tailwind como -translate-x-1/2 o -translate-y-1/2 para centrado/posicionamiento. Estas utilidades comparten la propiedad CSS transform que Motion.dev escribe en línea, por lo que la transformación de Motion puede borrar la traducción de diseño. Si se necesitan ambas, divide el elemento en un envoltorio de diseño estático que lleve la transformación de centrado/posicionamiento y un elemento motion.* interno que lleve rotate/scale/opacity animados, o codifica el desplazamiento de diseño en Motion mismo (x: "-50%") y mantenlo presente para cada keyframe.

Paso 4: Aplicar el movimiento en el código

  • ¿Los fragmentos contienen motion.dev? Usa el código de motion.dev textualmente para destinos React. Importa desde motion/react — a menos que la base de código ya use otra biblioteca de movimiento (Framer Motion, React Spring, GSAP), en cuyo caso adapta el fragmento a ella. Carga references/framework-recommendations.md al adaptar a otro stack o elegir una biblioteca.
  • ¿Los keyframes CSS están presentes? Úsalos para destinos vanilla/no React, o cuando la base de código no tenga una biblioteca de movimiento React.
  • ¿No hay fragmentos? Usa keyframeBindings o motionSummary como datos de respaldo para construir llamadas motion.dev o keyframes CSS equivalentes. Normalmente los fragmentos están presentes; haz esto solo cuando ambos formatos de fragmento falten genuinamente.

Paso 5: Validar

  • Lee las importaciones/convenciones de movimiento existentes del componente antes de añadir nuevas. Si el usuario ya usa Framer Motion / React Spring / anime.js, adáptate en lugar de forzar motion.dev.
  • Verifica puntualmente que una animación funcione de principio a fin (recarga, observa, itera) antes de hacer cambios por lotes en muchos nodos.
  • Carga references/gotchas.md y references/examples-and-anti-examples.md para orientación detallada y patrones de fusión comunes.

Recomendaciones de Framework

Cada salida de get_motion_context está etiquetada para el stack detectado del archivo Figma. Esta tabla mapea esos stacks a bibliotecas de animación de código típicas:

Stack detectadoBibliotecas de animación recomendadasUso del fragmento
React / Next.jsmotion (de motion.dev) — o Framer Motion, React Spring, GSAP si la base de código ya los usaUsa los fragmentos de motion.dev textualmente (o adáptalos a la biblioteca existente).
Vuemotion-v o @vueuse/motionTraduce los fragmentos de motion.dev a la API de la biblioteca elegida.
Angular@angular/animationsTraduce los fragmentos de motion.dev a definiciones de animación de Angular.
Sveltesvelte/motion o transiciones CSSUsa keyframes CSS o la API de tween de Svelte.
HTML/CSS (vanilla)Transiciones CSS o keyframes o anime.js / GSAPUsa fragmentos de keyframes CSS directamente.

Si el stack del usuario no figura en la tabla anterior, pregunta antes de decidir una biblioteca.

Referencias Relacionadas

Para cambios dentro de Figma, usa figma-use.

Individual skills in this repo

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

Skills relacionados