Communitygithub.com

reanimate

Mostra a um agente como planejar, construir ou ajustar uma "reanimação" para que o resultado concreto seja um corte de vídeo finalizado. O procedimento percorre o que significa "pronto", o Fluxo de Trabalho e o Escopo. Use quando uma nova tarefa exigir essa técnica.

O que é reanimate?

O skill **reanimate** é uma metodologia rigorosa e estruturada para agentes de IA (como Claude Code, Cursor, Codex) recriarem animações de interfaces web, vídeos, GIFs, canvas, WebGL e protótipos (Lottie/Rive) a partir de uma referência. Seu objetivo é transformar "parece certo" em evidência quantitativa: o agente captura quadros da referência, escreve uma especificação detalhada de movimento, implementa a animação no stack do usuário (lendo package.json e componentes existentes para não introduzir bibliotecas estranhas) e depois compara quadro a quadro com a implementação, usando métricas como erro de timing, diferença média de pixels e correspondência de easing. O processo é iterativo (2 a 5 rodadas típicas) e só para quando cada linha da especificação passa nos critérios de fidelidade — seja "fiel ao movimento" (apenas timing, easing e direção) ou "fiel ao pixel" (cores, fontes, espaçamento). O resultado final inclui código funcional, um relatório autossuficiente com tabelas de métricas e sheets de comparação visual, e documentação persistente em `.reanimate/<nome>/`. É ideal para tarefas de clonagem de animação, portabilidade de referências entre projetos ou ajuste fino de interações complexas, eliminando suposições subjetivas.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/PedroColbert/ai-skills-collection/tree/HEAD/reanimate

Perguntar na sua IA favorita

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

Documentação

O que reanimate faz?

Reconstrua o que o usuário apontar de modo que se mova como a referência se move, prove isso com uma comparação quadro a quadro e continue até que a comparação seja aprovada. A entrega é código no projeto do usuário mais evidência (números e folhas lado a lado), nunca "parece mais ou menos certo".

O que significa "pronto"

Escolha o nível de fidelidade a partir das palavras do usuário e declare-o na primeira mensagem; ele decide o que você verifica.

NívelQuandoDeve corresponderPode diferir
fiel ao movimento (padrão)"clonar essa animação", "deixar a nossa parecida com a deles", "mesmo herói que X mas nossa cópia"gatilho, sequência e ordem, stagger, temporização de cada passo (±80 ms), família de easing, direção e distância do movimento relativo ao tamanho do elemento, proporções do layoutcópia, cores, fontes, imagens, detalhes da marca
fiel ao pixel"igual exato", "perfeito em pixels", "detalhes devem bater", "1:1"tudo acima mais fontes, tamanhos, cores, espaçamento, raios, sombras, assets; diferença média entre quadros ≤ 2 %nada que o usuário não pediu para mudar
misto"clonar X e adicionar Y", "como o deles mas com nossos planos de preço"as partes clonadas em um dos níveis acimaas adições, que você descreve e mostra, mas verifica apenas se não quebram o movimento clonado

O usuário pode restringir o alvo a uma seção, um widget, uma página ou um intervalo de tempo de um vídeo ("os primeiros 3 segundos", "0:12 a 0:15"). Clone exatamente aquilo; não traga o resto da página.

Fluxo de trabalho

Tudo abaixo vive em .reanimate/<nome>/ dentro do projeto do usuário (adicione ao .gitignore a menos que ele queira a evidência commitada). Mantenha os artefatos de cada rodada; eles são a prova.

0. Escopo

Escreva três linhas no topo de .reanimate/<nome>/spec.md antes de qualquer captura:

  • Alvo: o que clonar, tão precisamente quanto o usuário disse (URL + seletor / intervalo de tempo / "o toggle no gif").
  • Destino: onde o código vai e em qual stack (leia package.json, componentes existentes e a biblioteca de animação já em uso; corresponda a ela em vez de introduzir uma nova).
  • Fidelidade: fiel ao movimento, fiel ao pixel ou misto, mais a lista de adições para misto.

Infira o que puder a partir da solicitação e do repositório. Pergunte apenas quando duas interpretações levarem a trabalhos diferentes (por exemplo, "o herói" em uma página com duas seções candidatas). Quando uma referência for uma página com login ou um link do YouTube/Loom que você não pode baixar aqui, peça ao usuário uma gravação de tela e continue com o resto enquanto isso.

1. Configuração

<skill> abaixo é o diretório onde este SKILL.md vive. Os scripts precisam de Bun; a primeira execução baixa o Chromium do Playwright e um ffmpeg estático (cerca de 250 MB).

bash <skill>/scripts/setup.sh      # instala playwright, ffmpeg, pixelmatch uma vez; imprime "pronto"

Todos os scripts são executados com bun <skill>/scripts/<nome>.ts --help. Eles são determinísticos e compartilham uma regra: capture a referência e o clone com o mesmo viewport, corte de seletor, gatilho, duração e fps, senão a comparação mede sua configuração em vez do seu trabalho.

2. Capturar a referência

Leia references/capture.md para a receita do seu tipo de fonte. Em resumo:

  • Site: capture.ts --url … --out ref --selector <seção> --trigger load|scroll|hover|click|none --duration … --track "<elementos em movimento>". Você obtém video.webm, frames/, inspect.json (animações declaradas, keyframes, estilos computados, fontes, bibliotecas detectadas) e track.json (por quadro de animação: posição, tamanho, opacidade, transform de cada elemento rastreado). Para movimento CSS/WAAPI, inspect.json frequentemente contém as durações, atrasos e easings exatos: use-os, é melhor do que estimar.
  • Vídeo ou gif: frames.ts --in arquivo --out ref/frames --fps 10..30 --start … --end … --crop …. Primeiro investigue com --probe, depois veja alguns quadros para encontrar o corte do widget que está clonando.
  • Canvas, WebGL, WebGPU, 3D (inspect.json › canvases mostra um, ou a página usa three.js, Pixi, Babylon, Spline…): adicione --clock virtual --gl --assets à captura e leia gl/summary.md (gl.ts summary <out>). Você obtém os códigos-fonte dos shaders, cada uniform constante, o grafo de cena, os passes de renderização, as texturas e modelos, e cada uniform animado ou propriedade de objeto como um canal em gl-track.json. O relógio virtual torna cada quadro exato e cada captura idêntica, partículas aleatórias incluídas. Leia references/webgl.md.
  • Lottie / Rive / exportação de protótipo: o arquivo é a especificação; leia-o, não o derive novamente de pixels.

Em seguida, construa folhas rotuladas e examine-as: sheet.ts filmstrip --frames ref/frames --out ref/sheets. Leia cada folha com o visualizador de imagens. Esta é a inspeção quadro a quadro que o usuário pediu; não pule nem amostre apenas a primeira folha.

3. Escrever a especificação do movimento

Preencha spec.md usando o modelo em references/analysis.md. Uma linha por elemento por propriedade: gatilho, tempo de início, duração, atraso ou stagger, de → para, easing, notas. Obtenha os números de, em ordem de preferência: animações e keyframes de inspect.json → easing.ts em track.json, ou em gl-track.json --channel para canvas → leitura dos quadros (primeiro quadro onde muda, último quadro onde muda, overshoot ou não). Anote também os fatos estáticos dos quais o movimento depende: tamanhos e posições dos elementos, ordem z, clipping por overflow, origens de transform e, para trabalho fiel ao pixel, fontes, cores, espaçamento e assets.

A especificação é o contrato entre a referência e o clone. Cada linha vira uma verificação no passo 5. Se uma linha tiver um "?", você não terminou de ler os quadros.

4. Construir

Implemente no stack do usuário seguindo references/implementation.md (tabelas de easing, matemática de stagger, gatilhos de scroll e hover, movimento reduzido). Mantenha a estrutura DOM próxima à estrutura de papéis da referência para que os seletores rastreados tenham equivalentes. Para trabalho misto, coloque as adições em componentes ou blocos claramente separados e mencione-os em spec.md sob "Adições".

Dê ao clone uma maneira de ser capturado da mesma forma que a referência: uma rota ou uma página estática que renderize o componente no viewport da referência com o mesmo gatilho. Um servidor de desenvolvimento serve (capture.ts --url http://localhost:5173/…); um arquivo HTML autônomo também funciona.

5. Verificar, corrigir, repetir

Capture o clone com o comando exato usado para a referência, alterando apenas --url e --out clone-N, então:

bun <skill>/scripts/compare.ts --ref ref/frames --clone clone-N/frames --out compare-N
bun <skill>/scripts/sheet.ts compare --ref ref/frames --clone clone-N/frames --diff compare-N/diff --out compare-N/sheets --every 2
bun <skill>/scripts/easing.ts --track clone-N/track.json --selector "<el>" --prop <translateY|opacity|…> --compare-track ref/track.json

Para trabalho em canvas, execute também gl.ts compare --ref ref --clone clone-N, que verifica configurações do canvas, estrutura de desenho e cada canal animado.

Leia references/verify.md para saber como ler o relatório, os critérios de aprovação para cada nível de fidelidade e as correções que cada tipo de falha geralmente precisa. Examine você mesmo as folhas de comparação, a cada rodada; os números dizem que algo está errado, as folhas dizem o quê.

Faça um loop até que cada linha da especificação passe. Cada rodada: mude a menor coisa que a evidência apontar, recapture, recompare. Espere de 2 a 5 rodadas. Se após 5 rodadas uma linha ainda falhar, pare e relate-a com seus números e o motivo (fonte ausente, um shader ou modelo que o usuário talvez não possa copiar, uma mola física que você aproximou), não abaixe silenciosamente o limiar nem descarte a linha.

6. Relatar

A mensagem final deve ser autossuficiente:

  • Nível de fidelidade e o que foi clonado, o que foi adicionado.
  • Onde está o código (arquivos) e como acionar o movimento.
  • Uma pequena tabela da última rodada de comparação: erro de temporização, diferença média, correspondência de easing por elemento-chave, passa/falha.
  • Caminhos para as folhas de comparação finais, incorporadas como imagens quando o ambiente as exibe.
  • Desvios residuais, cada um com um número e um motivo.

Armadilhas que desperdiçam rodadas

  • Viewport ou corte diferentes entre referência e clone: corrija a captura antes de tocar no código.
  • Julgar apenas pelo primeiro e último quadros: o easing vive nos quadros do meio; leia as folhas.
  • Fontes: uma fonte fallback diferente muda os pixels de cada quadro. Para trabalho fiel ao pixel, carregue a mesma fonte (de inspect.json fonts) antes de julgar a diferença; para trabalho fiel ao movimento, ignore pixels de texto e leia as colunas de temporização.
  • Referência gravada em uma página carregada vs clone capturado frio: use --wait-before, ou --trigger none com um --pre-js que reinicie a animação, para que ambos comecem do repouso.
  • Movimento acionado por scroll: é uma função da posição de scroll, não do tempo. Capture ambos com o mesmo --scroll-steps e --scroll-ms, e compare por posição de scroll (o scrollY do track), não por segundo.
  • Bibliotecas JS (GSAP, molas do Framer Motion): --playback-rate não as desacelera. Use track.json e easing.ts (ele relata overshoot e "tipo mola") e ajuste parâmetros de mola pelo overshoot e tempo de estabilização.
  • Vídeos da tela de outra pessoa têm cursor, borda do navegador e ruído de compressão: corte-os fora e aumente --pixel-threshold um pouco (0,15) em vez de caçar ruído.
  • Canvas e WebGL capturados no relógio real: quadros caem no GL de software e conteúdo aleatório difere a cada carregamento, então a comparação mede a máquina. Capture ambos os lados com --clock virtual e o mesmo --seed.
  • Reconstruir um shader a partir de screenshots: o trace já tem sua fonte e cada constante. Leia gl/shaders/ e os uniforms fixos antes de escrever GLSL.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas