Communitygithub.com

carrusel-motion

Crea carruseles de Instagram donde cada slide es un vídeo corto (1080x1350, 60 fps) que parece una hoja estática pero se anima con suavidad (texto que entra por líneas, rayas que se dibujan, contadores, botones). Úsala cuando pidan "carrusel en movimiento", "slides animados", "posts animados para Instagram" o convertir slides/imágenes estáticas en vídeos con micro-animación. Genera un MP4 mudo por slide con Remotion, con entrada y salida para que el bucle empalme sin saltos.

What is carrusel-motion?

carrusel-motion is a Claude Code agent skill that crea carruseles de Instagram donde cada slide es un vídeo corto (1080x1350, 60 fps) que parece una hoja estática pero se anima con suavidad (texto que entra por líneas, rayas que se dibujan, contadores, botones). Úsala cuando pidan "carrusel en movimiento", "slides animados", "posts animados para Instagram" o convertir slides/imágenes estáticas en vídeos con micro-animación. Genera un MP4 mudo por slide con Remotion, con entrada y salida para que el bucle empalme sin saltos.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m3nt41/carrusel-motion/tree/HEAD/carrusel-motion

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Carrusel en movimiento (Remotion)

Un carrusel de Instagram en el que cada slide es un vídeo de ~5 s que a primera vista parece un diseño estático, pero por dentro se mueve con suavidad. El contraste "parece quieto pero respira" engancha para seguir deslizando.

Cuándo usarla

  • Piden carrusel/posts/slides animados o "en movimiento" para Instagram.
  • Dan imágenes de slides estáticos (PNG) y quieren su versión animada.
  • Dan un tema/texto y quieren un carrusel animado desde cero.

Si piden un vídeo narrado de pantalla completa (9:16 con voz), esta skill NO es la adecuada.

Qué necesitas

  • Node.js 18 o superior. No hace falta ffmpeg ni claves de ningún servicio.
  • Si el usuario tiene logo o mascota: PNG con transparencia (o con fondo blanco; el script scripts/preparar-brand.py lo limpia, requiere Python con Pillow).
  • Los logos y las imágenes deben estar como archivos en la carpeta del proyecto. Una imagen pegada en el chat NO es un archivo: Claude puede mirarla, pero no puede copiarla al proyecto. Si el usuario pega su logo, pídele que lo guarde en public/brand/.
  • Licencia de Remotion: gratis para personas y equipos de hasta 3; las empresas más grandes necesitan licencia (condiciones vigentes en https://www.remotion.dev/docs/license). Avísalo si el usuario parece trabajar para una empresa.

Flujo de trabajo

  1. Entender el contenido. Si hay imágenes de slides, léelas (son imágenes: míralas) y transcribe el texto tal cual. Se puede acortar o partir si el diseño lo pide (por ejemplo evitar una palabra huérfana en una línea), pero no cambies el sentido ni inventes datos.
  2. Elegir un estilo propio para este carrusel (ver referencias/variedad-de-estilo.md). No copies el estilo de otro carrusel por comodidad. Si el usuario tiene una identidad (por ejemplo "fondo negro y texto blanco"), respétala y varía otros ejes (composición, elementos animados).
  3. Montar el proyecto. Si no existe uno, copia la carpeta plantilla/ de esta skill a donde trabaje el usuario y ejecuta npm install. La plantilla trae un CLAUDE.md con las reglas básicas: ayuda al usuario a rellenarlo con su marca (así no tiene que repetirlo en cada sesión). Si ya existe, añade un carrusel nuevo en src/carousels/<slug>/ y regístralo en src/carousels/index.tsx.
  4. Construir cada slide con los bloques de plantilla/src/carousels/ejemplo/style.tsx (Block, Title, Body, Eyebrow, GhostNumber, Cta, Header, Footer). Un slide = una composición <slug>-01, <slug>-02...
  5. Revisar fotogramas de verdad antes de renderizar: npx remotion still src/index.ts <slug>-01 salida.png --frame=200 en cuatro momentos (entrada ~frame 10, reposo ~200, salida ~285 y el último, 299) y mira cada imagen. Comprueba texto cortado, solapes, márgenes y que el último fotograma quede vacío (salvo cabecera y pie fijos).
  6. Renderizar un MP4 por slide (ver comando abajo) y entregar la lista de archivos.
  7. Decir con honestidad qué no se comprobó: que has visto fotogramas pero no el movimiento, que no has probado la subida a Instagram.

Formato (innegociable)

  • 1080 × 1350 (4:5), composiciones de 300 fotogramas a 60 fps (5 s), sin audio (--muted).
  • Márgenes laterales de 80 px. Nada importante en los bordes. (La cuadrícula del perfil de Instagram recorta 4:5 a 3:4, unos 34 px por lado: con 80 px de margen no se pierde nada.)
  • Portada (slide 1) — OBLIGATORIO: SIN entrada. Todo el contenido (titular, textos, mascota) debe estar visible y en su sitio en el fotograma 0, porque la vista previa/miniatura de Instagram usa ese fotograma: si la portada entra desde vacío, la publicación sale en blanco. Se consigue con enterAt muy negativo (en la plantilla, COVER = -200). Después se mueve con normalidad: micro-movimiento periódico y la misma salida al final que los demás. Solo cambia la entrada; el resto del proceso es igual. Los demás slides (2…N) siguen entrando desde vacío y saliendo a vacío. Comprobación: --frame=0 de la portada nunca puede salir vacío.
  • Salida: out/carruseles/<slug>/<slug>_01.mp4, _02.mp4...

Comando de render por slide:

npx remotion render src/index.ts <slug>-01 out/carruseles/<slug>/<slug>_01.mp4 --codec=h264 --crf=16 --pixel-format=yuv420p --image-format=png --muted

También puedes usar node scripts/render-carrusel.mjs <slug> <nº de slides> que los hace todos.

Reglas de fluidez (lo que evita que "vaya con lag" en el móvil)

Detalle en referencias/fluidez.md. Resumen:

  • 60 fps y curvas suaves (easeOutCubic, easeInOutCubic), entradas de ~0,6 s. Evita curvas exponenciales agresivas: arrancan de golpe y arrastran micro-pasos.
  • Entrada Y salida en cada slide. Todo el contenido termina invisible en el último fotograma para que, al repetirse el vídeo, empalme sin salto. Comprueba siempre el fotograma 299: un estilo inline que anula la opacidad de un contenedor (por ejemplo opacity: undefined) puede dejarlo visible.
  • Solo animar transform y opacity. Nada de filtros (blur, displacement) ni grano/ruido en el fondo: Instagram recomprime y parpadea. Las sombras y brillos van horneados (fijos), nunca animados.
  • Si animas un personaje o ilustración: assets en SVG o PNG de alta resolución, contorno de grosor consistente, escalado siempre proporcional y squash & stretch sutil (±2-3 %). En plantilla/src/motion.ts hay helpers (bell, hold, wobble, win) para eventos puntuales que empiezan y acaban en reposo.
  • Cabecera y pie fijos: menos cosas moviéndose = sensación más suave.
  • Movimiento ambiente periódico (funciones loop con periodo = duración) para que el bucle sea continuo.
  • Todo determinista: nada de Math.random ni temporizadores; todo en función del fotograma.

Reglas de contenido y marca

  • No copies logos de marcas ajenas. Usa solo el logo/mascota que aporte el usuario, en public/brand/.
  • No inventes cifras, precios ni afirmaciones: usa las que da el usuario.
  • Respeta la identidad visual que el usuario indique (colores, fondo, tipografía) y varía dentro de ella.

Archivos de esta skill

  • plantilla/ — proyecto Remotion mínimo y funcional con un carrusel de ejemplo de 3 slides.
  • referencias/fluidez.md — por qué y cómo lograr movimiento fluido en móvil.
  • referencias/variedad-de-estilo.md — ejes para que cada carrusel tenga su propio aspecto.
  • referencias/qa-checklist.md — lista de comprobación antes de entregar.
  • plantilla/CLAUDE.md — reglas del proyecto para rellenar con la marca del usuario.
  • plantilla/scripts/preparar-brand.py — recorta el logo y quita el fondo blanco de una mascota.

Related Skills