Communitygithub.com

toy-loops

Crie animações 3D contínuas no estilo diorama de papel (GIF e MP4), imagens heroicas para web e peças interativas ao vivo (olhos de Claude seguindo o cursor), tudo construído em Python e renderizado no Blender, animado com os princípios clássicos de animação.

O que é toy-loops?

O **toy-loops** é uma skill especializada para agentes de IA como Claude Code, Cursor ou Codex, projetada para criar animações 3D em loop e imagens estáticas com a estética de um mundo em miniatura feito de papel. A skill utiliza Python para construir cada objeto e o Blender para renderizar, garantindo loops perfeitos ao calcular cada quadro a partir do seu número de sequência. Ela suporta a criação de GIFs (1080x1080), MP4s, imagens heroicas para web (2400x1200) e peças interativas ao vivo onde os olhos de Claude seguem o cursor do mouse. O sistema é baseado em regras rígidas de animação — como antecipação, compressão e estiramento, e uso de dope sheets — e inclui ferramentas de QA para verificar costuras, quadros parados e movimento. O fluxo de trabalho começa sempre com a exibição de imagens de referência para aprovação do usuário (Pimbo) antes da construção completa, e todo o pipeline é executado via linha de comando a partir de uma pasta específica no PC do usuário.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Pimboto/claude-skills/tree/HEAD/skills/toy-loops

Perguntar na sua IA favorita

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

Documentação

O que toy-loops faz?

Pequenos mundos de artesanato em papel (uma ilha, um acampamento, um set de filmagem), Claude como ator, luz suave e quente e uma profundidade de campo rasa como uma miniatura. Cada objeto é construído a partir de código e cada quadro é calculado a partir do seu número, para que um loop feche exatamente. O visual foi estudado a partir das referências do Pimbo em anymation/3d_ref/style2 com a skill reference-video-analysis (primeira passagem: 3d_ref/style2/analysis/FIRST_PASS.md). Essas referências são material de estudo privado: copie a técnica, nunca as suas cenas.

Status: v1, 2026-11-18. Peças feitas com ele e verificadas:

  • claude_isla: aprovada por Pimbo ("esta épica").
  • claude_fogata: o segundo loop.
  • director_hero: uma imagem heroica para web de 2400x1200, feita em duas colorações.
  • claude_pose: o recorte com olhos ao vivo para web.
  • claude.glb: o modelo 3D.

Onde tudo vive

O código é uma pasta no PC do Pimbo: C:\Users\Pimbo\work\anymation\toy3d\skill. Todo caminho abaixo é relativo à sua pasta kit/, a menos que indicado o contrário.

CaminhoO que é
lib/toy.pyO visual: materiais de papel com bordas brancas biseladas, formas, luz, câmera, configurações de renderização
lib/anim.pyAs ferramentas do animador: curvas de suavização, Track (pose a pose), molas, squash, arc, looped
lib/chars.pyClaude: o rig e seus seis conjuntos de olhos; .pose(...) uma vez por quadro
lib/runner.pyRenderiza uma cena quadro a quadro; toda cena termina com runner.run(...)
loops/<nome>/scene.pyUma animação em loop
stills/<nome>/scene.pyUma imagem (T = 1)
tools/make_loop.pyRenderizar, codificar GIF 1080/720 e MP4 x1/x3, QA, tabela de contato, em um comando
tools/qa_loop.pyCostura do loop, contagem de quadros, pausas mortas, movimento comparado com as referências
tools/duotone.pyVersão monocromática azul de uma imagem (estilo heroico para web)
tools/web_eyes.pyUma página web onde os olhos de Claude seguem o cursor, a partir de uma renderização sem olhos
tools/claude_glb.pyO modelo Claude como um .glb (cores planas, bordas brancas mantidas), executado dentro do Blender
out/<nome>/Saída: frames/, os arquivos, sheet.jpg, qa.json

Peças finalizadas são copiadas para anymation/toy3d/videos/<nome>/; peças web ficam em anymation/toy3d/web/.

Necessita:

  • Blender 5.2: a cópia portátil do Pimbo está em anymation/tools/blender; em outros lugares defina $BLENDER ou coloque blender no PATH.
  • ffmpeg no PATH.
  • Python com numpy e Pillow, para as ferramentas.

Pimbo não executa scripts: você os executa e mostra a ele as imagens.

Regras que não se dobram

  1. Mostre antes de construir. Antes de um novo mundo ou personagem, renderize 2-3 imagens estáticas (--frames ... --scale 0.5) e deixe Pimbo escolher. Olhe para cada imagem você mesmo antes de mostrá-la.
  2. pose(f) é uma função pura do quadro. Nenhum estado carregado entre quadros, nenhum número aleatório sem uma semente fixa, cada movimento periódico com um número inteiro de ciclos por loop. Efeitos que cruzam o final do loop usam looped().
  3. Anime como um animador (references/ANIMATION.md). Escreva uma dope sheet primeiro, depois use poses-chave com curvas de suavização. Use antecipação antes de cada ação, compressão no impacto e estiramento na velocidade, sobreposição nos braços e trocas de olhos de um quadro. Nunca mova um corpo linearmente.
  4. Um loop só está pronto quando o QA passa (make_loop.py imprime PASS/FAIL) e você olhou para uma tira quadro a quadro de cada ação (veja "Tiras" abaixo).
  5. Diga o que foi medido [M], visto [V] e assumido [S].

Pipeline

EtapaO quêComando (a partir de kit/)
1Ideia: lugar, uma pequena história com início e retorno ao loop; 6-9 sfalar com Pimbo
2Copiar a cena mais próxima: loops/claude_isla (dia, externo) ou loops/claude_fogata (noite, adereços, efeitos)
3Construir o cenário, posicionar Claude, luz e câmera; olhar as imagens estáticaspython tools/make_loop.py <nome> --frames 0 --scale 0.5
4Comentário da dope sheet, depois os Tracks; renderizar as poses-chavepython tools/make_loop.py <nome> --frames 44,62,66,71,77,81
5Olhada rápida no loop inteiropython tools/make_loop.py <nome> --preview (a cada 8 quadros)
6Renderização completa + GIF + MP4 + QApython tools/make_loop.py <nome>
7Tiras de cada ação, corrigir, re-renderizarveja "Tiras" abaixo
8Copiar os arquivos finalizados para anymation/toy3d/videos/<nome>/ e enviá-los para Pimbo

Tempos no PC do Pimbo (RX 6800 XT) [M]:

  • EEVEE: cerca de 0.7 s por quadro 1080x1080, então um loop de 200 quadros leva cerca de 2.5 minutos.
  • Cycles: cerca de 10 s por quadro e parece quase igual. Use apenas para imagens estáticas: --engine cycles --samples 256 leva cerca de 20 s em 2400x1200.

Tiras. Para olhar uma ação quadro a quadro:

ffmpeg -framerate 25 -start_number 56 -i out/<n>/frames/%04d.png -frames:v 30 -vf "crop=...,scale=260:-1,tile=6x5" -frames:v 1 strip.jpg

Visual, resumidamente (detalhes e números: references/LOOK.md)

  • Escala de brinquedo. 1 unidade = 1 m e Claude tem cerca de 9 cm de largura. A profundidade de campo real da câmera (70 mm, f/4.5-7) então fornece o desfoque de miniatura por si só.
  • Papel. Cada sólido recebe paper(...): cor mate, relevo de fibra, manchas suaves. Bordas biseladas recebem o material de borda branca automaticamente (box, prism, disc).
  • Cor. Transformação de visualização AgX com o visual Punchy. Exposição -1 para dia e cerca de -0.35 para noite.
    • Faces iluminadas: as faces iluminadas de Claude medem próximas às referências (nossa #DA8D6C, referências #EC815B).
    • Brilho: quadros diurnos têm um brilho médio de 120-140 (referências 91-181).
  • Luz. Uma chave quente, alta e na frente, para que a face superior seja mais brilhante que a frontal. Adicione um preenchimento frio fraco e um contorno quente. Coisas brilhantes (chamas, estrelas, sopros) usam flame_mat e no_shadow.
  • Câmera. Fica parada em loops (as referências movem a câmera apenas para um corte ou um zoom).
    • Quadrada 1080 para GIFs.
    • Heroicas são largas, com shift_x empurrando o sujeito para um terço.

Claude, resumidamente (references/CHARACTERS.md)

claude = Claude('claude', loc), então uma vez por quadro:

claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
  • Olhos: sq, happy (^ ^), line (- -), squeeze (> <), dot (. .), sad.
  • Adereços: um adereço segurado é parente de claude.hand(side).
  • Acenando: o braço que acena deve ser o que está virado para a câmera.

Peças web: olhos ao vivo e o modelo 3D

  • Olhos ao vivo.
    1. Renderize com --eyes-off (e --transparent para um recorte): python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. O runner esconde os olhos e escreve eyes.json: o centro de cada olho em pixels e os eixos faciais em pixels por mm.
    2. Execute python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render com olhos>. Ele escreve index.html mais um arquivo único <dir>_un_archivo.html.
    3. O que a página faz:
      • Os olhos são formas SVG desenhadas no plano facial, então a perspectiva está correta mesmo em um rosto inclinado.
      • Eles seguem o ponteiro com uma mola subamortecida e piscam a cada 2.5-5.5 s.
      • ^ ^ quando o ponteiro está perto, > < enquanto pressionado.
      • Um salto de compressão e estiramento ao clicar (não com --hero, que mantém uma imagem completa parada).
    4. Testado no Chrome através do playwright (ponteiro esquerda, direita, cima, baixo, perto, pressionar, soltar): sem erros no console.
  • Modelo 3D. Execute blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Ele escreve um GLB de 27 KB, com cerca de 9 cm de largura, reimportado e verificado.
  • Cenas e --eyes-off. Uma cena que posiciona Claude em tempo de construção deve posicioná-lo novamente dentro de pose(f); --eyes-off só tem efeito lá (veja stills/director_hero).

Portões de qualidade (tools/qa_loop.py)

FALHA:

  • Contagem de quadros errada.
  • Uma costura: o passo do último quadro para o primeiro é maior que o percentil 90 dos passos normais.

AVISO:

  • Quadros consecutivos idênticos (uma pausa morta).
  • Movimento abaixo de 0.8 % do brilho médio. Medido [M]: referências r2/r3/r4 1.65/1.97/1.07 %, claude_isla 0.89 %, claude_fogata 1.66 %.

O QA não pode julgar gosto, atuação ou enquadramento. Estes são verificados visualmente nas imagens estáticas e tiras.

Erros conhecidos (references/KNOWN_ERRORS.md)

Os que custam uma re-renderização:

  • Um braço levantado acima de cerca de 70° se esconde ao lado do corpo.
  • Emissão brilhante desbota para branco sob AgX: use flame_mat.
  • Uma chave lateral deixa a face frontal escura.
  • Uma cena noturna medida com níveis de cinza absolutos parece "muito quieta".
  • Um arco de fundo curvo que é muito estreito mostra sua borda.

Individual skills in this repo

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

Habilidades Relacionadas