Communitygithub.com

carrusel-motion

Cria carrosséis do Instagram onde cada slide é um vídeo curto (1080×1350, 60 fps) que parece uma folha estática, mas se anima suavemente (texto que entra por linhas, traços que se desenham, contadores, botões). Use quando pedirem "carrossel em movimento", "slides animados", "posts animados para o Instagram" ou para converter slides/imagens estáticas em vídeos com micro-animação. Gera um MP4 mudo por slide com Remotion, com entrada e saída para que o loop emende sem saltos.

O que é carrusel-motion?

Esta skill permite criar carrosséis animados para o Instagram, onde cada slide é um vídeo de aproximadamente 5 segundos renderizado com Remotion. O contraste entre a aparência estática e o movimento sutil (texto entrando linha por linha, linhas se desenhando, contadores e botões animados) prende a atenção do espectador. A skill suporta Node.js 18+, não requer ffmpeg ou chaves de API, e gera MP4s mudos no formato 1080×1350 (4:5) a 60 fps. O fluxo de trabalho inclui a transcrição fiel do conteúdo do usuário, escolha de um estilo visual único para cada projeto, montagem da estrutura de pastas a partir de uma plantilla, construção de cada slide com blocos pré-definidos (como Block, Title, Body, Cta) e verificação rigorosa de quadros-chave (entrada, repouso, saída) antes da renderização final. Regras importantes garantem fluidez em dispositivos móveis: animações apenas em transform e opacity, curvas suaves (easeOutCubic), entrada e saída em todos os slides para loops contínuos, e elementos fixos (cabeçalho e rodapé) para reduzir movimento. A portada (slide 1) deve ter conteúdo visível desde o frame 0 para evitar que a miniatura do Instagram apareça em branco.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Carrossel em movimento (Remotion)

Um carrossel do Instagram onde cada slide é um vídeo de ~5 s que à primeira vista parece um design estático, mas por dentro se movimenta suavemente. O contraste "parece parado mas respira" prende para continuar deslizando.

Quando usar

  • Pedem carrossel/posts/slides animados ou "em movimento" para o Instagram.
  • Fornecem imagens de slides estáticos (PNG) e querem sua versão animada.
  • Fornecem um tema/texto e querem um carrossel animado do zero.

Se pedirem um vídeo narrado em tela cheia (9:16 com voz), esta skill NÃO é adequada.

O que você precisa

  • Node.js 18 ou superior. Não precisa de ffmpeg nem chaves de nenhum serviço.
  • Se o usuário tiver logotipo ou mascote: PNG com transparência (ou com fundo branco; o script scripts/preparar-brand.py o limpa, requer Python com Pillow).
  • Os logotipos e as imagens devem estar como arquivos na pasta do projeto. Uma imagem colada no chat NÃO é um arquivo: Claude pode olhá-la, mas não pode copiá-la para o projeto. Se o usuário colar seu logotipo, peça para que o salve em public/brand/.
  • Licença do Remotion: gratuita para pessoas e equipes de até 3; empresas maiores precisam de licença (condições vigentes em https://www.remotion.dev/docs/license). Avise se o usuário parecer trabalhar para uma empresa.

Fluxo de trabalho

  1. Entender o conteúdo. Se houver imagens de slides, leia-as (são imagens: olhe para elas) e transcreva o texto tal qual. Pode-se encurtar ou dividir se o design pedir (por exemplo, evitar uma palavra órfã em uma linha), mas não mude o sentido nem invente dados.
  2. Escolher um estilo próprio para este carrossel (ver referencias/variedade-de-estilo.md). Não copie o estilo de outro carrossel por comodidade. Se o usuário tem uma identidade (por exemplo "fundo preto e texto branco"), respeite-a e varie outros eixos (composição, elementos animados).
  3. Montar o projeto. Se não existir um, copie a pasta plantilla/ desta skill para onde o usuário trabalha e execute npm install. A plantilla traz um CLAUDE.md com as regras básicas: ajude o usuário a preenchê-lo com sua marca (assim ele não precisa repetir em cada sessão). Se já existir, adicione um novo carrossel em src/carousels/<slug>/ e registre-o em src/carousels/index.tsx.
  4. Construir cada slide com os blocos de plantilla/src/carousels/ejemplo/style.tsx (Block, Title, Body, Eyebrow, GhostNumber, Cta, Header, Footer). Um slide = uma composição <slug>-01, <slug>-02...
  5. Revisar quadros de verdade antes de renderizar: npx remotion still src/index.ts <slug>-01 salida.png --frame=200 em quatro momentos (entrada ~frame 10, repouso ~200, saída ~285 e o último, 299) e veja cada imagem. Verifique texto cortado, sobreposições, margens e se o último quadro fica vazio (exceto cabeçalho e rodapé fixos).
  6. Renderizar um MP4 por slide (ver comando abaixo) e entregar a lista de arquivos.
  7. Dizer com honestidade o que não foi verificado: que você viu quadros mas não o movimento, que não testou o upload para o Instagram.

Formato (innegociável)

  • 1080 × 1350 (4:5), composições de 300 quadros a 60 fps (5 s), sem áudio (--muted).
  • Margens laterais de 80 px. Nada importante nas bordas. (A grade do perfil do Instagram recorta 4:5 para 3:4, cerca de 34 px por lado: com 80 px de margem não se perde nada.)
  • Capa (slide 1) — OBRIGATÓRIO: SEM entrada. Todo o conteúdo (título, textos, mascote) deve estar visível e em seu lugar no quadro 0, porque a pré-visualização/miniatura do Instagram usa esse quadro: se a capa entra a partir do vazio, a publicação sai em branco. Consegue-se com enterAt muito negativo (na plantilla, COVER = -200). Depois se move normalmente: micro-movimento periódico e a mesma saída no final que os demais. Apenas muda a entrada; o resto do processo é igual. Os demais slides (2…N) continuam entrando a partir do vazio e saindo para o vazio. Verificação: --frame=0 da capa nunca pode sair vazio.
  • Saída: 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

Também pode usar node scripts/render-carrusel.mjs <slug> <nº de slides> que faz todos.

Regras de fluidez (o que evita que "vá com lag" no celular)

Detalhe em referencias/fluidez.md. Resumo:

  • 60 fps e curvas suaves (easeOutCubic, easeInOutCubic), entradas de ~0,6 s. Evite curvas exponenciais agressivas: arrancam de repente e arrastam micro-passos.
  • Entrada E saída em cada slide. Todo o conteúdo termina invisível no último quadro para que, ao repetir o vídeo, emende sem salto. Verifique sempre o quadro 299: um estilo inline que anula a opacidade de um contêiner (por exemplo opacity: undefined) pode deixá-lo visível.
  • Apenas animar transform e opacity. Nada de filtros (blur, displacement) nem grão/ruído no fundo: o Instagram re-comprime e pisca. As sombras e brilhos vão assados (fixos), nunca animados.
  • Se animar um personagem ou ilustração: assets em SVG ou PNG de alta resolução, contorno de espessura consistente, escalonamento sempre proporcional e squash & stretch sutil (±2-3 %). Em plantilla/src/motion.ts há helpers (bell, hold, wobble, win) para eventos pontuais que começam e terminam em repouso.
  • Cabeçalho e rodapé fixos: menos coisas se movendo = sensação mais suave.
  • Movimento ambiente periódico (funções loop com período = duração) para que o loop seja contínuo.
  • Tudo determinístico: nada de Math.random nem temporizadores; tudo em função do quadro.

Regras de conteúdo e marca

  • Não copie logotipos de marcas alheias. Use apenas o logotipo/mascote que o usuário fornecer, em public/brand/.
  • Não invente cifras, preços nem afirmações: use as que o usuário fornece.
  • Respeite a identidade visual que o usuário indicar (cores, fundo, tipografia) e varie dentro dela.

Arquivos desta skill

  • plantilla/ — projeto Remotion mínimo e funcional com um carrossel de exemplo de 3 slides.
  • referencias/fluidez.md — por que e como conseguir movimento fluido no celular.
  • referencias/variedade-de-estilo.md — eixos para que cada carrossel tenha seu próprio aspecto.
  • referencias/qa-checklist.md — lista de verificação antes de entregar.
  • plantilla/CLAUDE.md — regras do projeto para preencher com a marca do usuário.
  • plantilla/scripts/preparar-brand.py — recorta o logotipo e remove o fundo branco de uma mascote.

Habilidades Relacionadas