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ível | Quando | Deve corresponder | Pode 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 layout | có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 acima | as 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émvideo.webm,frames/,inspect.json(animações declaradas, keyframes, estilos computados, fontes, bibliotecas detectadas) etrack.json(por quadro de animação: posição, tamanho, opacidade, transform de cada elemento rastreado). Para movimento CSS/WAAPI,inspect.jsonfrequentemente 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 › canvasesmostra um, ou a página usa three.js, Pixi, Babylon, Spline…): adicione--clock virtual --gl --assetsà captura e leiagl/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 emgl-track.json. O relógio virtual torna cada quadro exato e cada captura idêntica, partículas aleatórias incluídas. Leiareferences/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.jsonfonts) 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 nonecom um--pre-jsque 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-stepse--scroll-ms, e compare por posição de scroll (oscrollYdo track), não por segundo. - Bibliotecas JS (GSAP, molas do Framer Motion):
--playback-ratenão as desacelera. Usetrack.jsoneeasing.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-thresholdum 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 virtuale 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.