Communitygithub.com

toy-loops

Crea animaciones 3D sin costuras (GIF y MP4), imágenes hero web y piezas web en vivo (ojos de Claude que siguen el cursor) con aspecto de diorama de papel, construido completamente en Python y renderizado en Blender, animado con los principios clásicos de animación (anticipación, squash y stretch, seguimiento, exageración). Úsalo cuando Pimbo solicite un GIF, un bucle, un juguete, papel o animación de diorama, una animación de Claude, una imagen hero, ojos que sigan el mouse o el modelo 3D de Claude.

¿Qué es toy-loops?

Esta habilidad permite crear animaciones 3D en bucle sin costuras, imágenes hero para la web y piezas web interactivas con un estilo artesanal de diorama de papel, utilizando únicamente Python y Blender. Está diseñada para el flujo de trabajo de Pimbo, ofreciendo herramientas para construir escenas, animar personajes (como Claude) con principios clásicos de animación (anticipación, squash y stretch, seguimiento), y generar salidas en GIF, MP4 o imágenes estáticas. Soporta la creación de piezas web donde los ojos de Claude siguen el cursor del ratón y la exportación del modelo 3D a formato GLB. La habilidad incluye un pipeline completo con pasos de previsualización, renderizado, QA automático y herramientas para inspeccionar fotogramas. Funciona con Blender 5.2 y requiere Python con numpy y Pillow. Está pensada para que el desarrollador ejecute los comandos y muestre los resultados a Pimbo, siguiendo reglas estrictas como mostrar bocetos antes de construir, usar funciones puras por fotograma y pasar controles de calidad antes de considerar terminado un bucle.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace toy-loops?

Pequeños mundos de papel recortado (una isla, un campamento, un set de cine), Claude como actor, luz cálida suave y una profundidad de campo reducida como de miniatura. Cada objeto se construye con código y cada fotograma se computa a partir de su número, por lo que un bucle cierra exactamente. El aspecto se estudió a partir de las referencias de Pimbo en anymation/3d_ref/style2 con la habilidad reference-video-analysis (primer pase: 3d_ref/style2/analysis/FIRST_PASS.md). Esas referencias son material de estudio privado: copia la artesanía, nunca sus escenas.

Estado: v1, 2026-11-18. Piezas realizadas con él y verificadas:

  • claude_isla: aprobado por Pimbo ("esta épica").
  • claude_fogata: el segundo bucle.
  • director_hero: una imagen hero web de 2400x1200, realizada en dos combinaciones de color.
  • claude_pose: el recorte con ojos web en vivo.
  • claude.glb: el modelo 3D.

Dónde vive todo

El código es una carpeta en el PC de Pimbo: C:\Users\Pimbo\work\anymation\toy3d\skill. Cada ruta a continuación es relativa a su carpeta kit/ a menos que se indique lo contrario.

RutaQué es
lib/toy.pyEl aspecto: materiales de papel con bordes biselados blancos, formas, luz, cámara, ajustes de renderizado
lib/anim.pyLas herramientas del animador: easing, Track (pose a pose), resortes, squash, arc, looped
lib/chars.pyClaude: el rig y sus seis juegos de ojos; .pose(...) una vez por fotograma
lib/runner.pyRenderiza una escena fotograma a fotograma; cada escena termina con runner.run(...)
loops/<nombre>/scene.pyUna animación en bucle
stills/<nombre>/scene.pyUna imagen (T = 1)
tools/make_loop.pyRenderizar, codificar GIF 1080/720 y MP4 x1/x3, QA, hoja de contactos, en un solo comando
tools/qa_loop.pyCostura del bucle, conteo de fotogramas, pausas muertas, movimiento comparado con las referencias
tools/duotone.pyVersión monocromática azul de una imagen (estilo hero web)
tools/web_eyes.pyUna página web donde los ojos de Claude siguen el cursor, a partir de un render sin ojos
tools/claude_glb.pyEl modelo de Claude como .glb (colores planos, bordes blancos conservados), ejecutar dentro de Blender
out/<nombre>/Salida: frames/, los archivos, sheet.jpg, qa.json

Las piezas terminadas se copian a anymation/toy3d/videos/<nombre>/; las piezas web viven en anymation/toy3d/web/.

Necesita:

  • Blender 5.2: la copia portátil de Pimbo está en anymation/tools/blender; en otro lugar configura $BLENDER o pon blender en el PATH.
  • ffmpeg en el PATH.
  • Python con numpy y Pillow, para las herramientas.

Pimbo no ejecuta scripts: tú los ejecutas y le muestras las imágenes.

Reglas que no se doblan

  1. Mostrar antes de construir. Antes de un nuevo mundo o personaje, renderiza 2-3 imágenes fijas (--frames ... --scale 0.5) y deja que Pimbo elija. Mira tú mismo cada imagen antes de mostrarla.
  2. pose(f) es una función pura del fotograma. Sin estado entre fotogramas, sin números aleatorios sin una semilla fija, cada movimiento periódico con un número entero de ciclos por bucle. Los efectos que cruzan el final del bucle usan looped().
  3. Anima como un animador (references/ANIMATION.md). Escribe primero una hoja de dope, luego usa poses clave con easing. Usa anticipación antes de cada acción, squash en el impacto y stretch en la velocidad, superposición en los brazos, e intercambios de ojos de un fotograma. Nunca muevas un cuerpo linealmente.
  4. Un bucle está terminado solo cuando el QA pasa (make_loop.py imprime PASS/FAIL) y has visto una tira fotograma a fotograma de cada acción (ver "Tiras" más abajo).
  5. Di qué fue medido [M], visto [V] y asumido [S].

Pipeline

PasoQuéComando (desde kit/)
1Idea: lugar, una pequeña historia con principio y vuelta al bucle; 6-9 shablar con Pimbo
2Copiar la escena más cercana: loops/claude_isla (día, exterior) o loops/claude_fogata (noche, atrezo, efectos)
3Construir el set, colocar a Claude, luz y cámara; mirar imágenes fijaspython tools/make_loop.py <nombre> --frames 0 --scale 0.5
4Comentario de la hoja de dope, luego los Tracks; renderizar las poses clavepython tools/make_loop.py <nombre> --frames 44,62,66,71,77,81
5Vista rápida de todo el buclepython tools/make_loop.py <nombre> --preview (cada 8.º fotograma)
6Render completo + GIF + MP4 + QApython tools/make_loop.py <nombre>
7Tiras de cada acción, corregir, volver a renderizarver "Tiras" más abajo
8Copiar los archivos terminados a anymation/toy3d/videos/<nombre>/ y enviarlos a Pimbo

Tiempos en el PC de Pimbo (RX 6800 XT) [M]:

  • EEVEE: aproximadamente 0.7 s por fotograma 1080x1080, por lo que un bucle de 200 fotogramas tarda unos 2.5 minutos.
  • Cycles: aproximadamente 10 s por fotograma y se ve casi igual. Úsalo solo para imágenes fijas: --engine cycles --samples 256 tarda unos 20 s a 2400x1200.

Tiras. Para ver una acción fotograma a fotograma:

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

Aspecto, en resumen (detalles y números: references/LOOK.md)

  • Escala de juguete. 1 unidad = 1 m y Claude mide unos 9 cm de ancho. La profundidad de campo real de la cámara (70 mm, f/4.5-7) da entonces el desenfoque de miniatura por sí misma.
  • Papel. Cada sólido recibe paper(...): color mate, relieve de fibra, manchas suaves. Los bordes biselados reciben automáticamente el material de borde blanco (box, prism, disc).
  • Color. Transformación de vista AgX con el aspecto Punchy. Exposición -1 para día y aproximadamente -0.35 para noche.
    • Caras iluminadas: las caras iluminadas de Claude miden cerca de las referencias (nuestras #DA8D6C, referencias #EC815B).
    • Brillo: los fotogramas de día tienen un brillo medio de 120-140 (referencias 91-181).
  • Luz. Una clave cálida, alta y al frente, para que la cara superior sea más brillante que la frontal. Añade un relleno frío suave y un reborde cálido. Las cosas que brillan (llamas, estrellas, bocanadas) usan flame_mat y no_shadow.
  • Cámara. Se mantiene quieta en los bucles (las referencias mueven la cámara solo para un corte o un acercamiento).
    • Cuadrada 1080 para GIFs.
    • Las imágenes hero son anchas, con shift_x empujando al sujeto a un tercio.

Claude, en resumen (references/CHARACTERS.md)

claude = Claude('claude', loc), luego una vez por fotograma:

claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
  • Ojos: sq, happy (^ ^), line (- -), squeeze (> <), dot (. .), sad.
  • Atrezo: un objeto sostenido se emparenta a claude.hand(lado).
  • Saludo: el brazo que saluda debe ser el que mira hacia la cámara.

Piezas web: ojos en vivo y el modelo 3D

  • Ojos en vivo.
    1. Renderiza con --eyes-off (y --transparent para un recorte): python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. El runner oculta los ojos y escribe eyes.json: el centro de píxel de cada ojo y los ejes de la cara en píxeles por mm.
    2. Ejecuta python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render con ojos>. Escribe index.html más un archivo único <dir>_un_archivo.html.
    3. Qué hace la página:
      • Los ojos son formas SVG dibujadas en el plano de la cara, por lo que la perspectiva es correcta incluso en una cara inclinada.
      • Siguen el puntero con un resorte subamortiguado y parpadean cada 2.5-5.5 s.
      • ^ ^ cuando el puntero está cerca, > < mientras se presiona.
      • Un rebote de squash-and-stretch al hacer clic (no con --hero, que mantiene una imagen completa quieta).
    4. Probado en Chrome mediante playwright (puntero izquierda, derecha, arriba, abajo, cerca, presionar, soltar): sin errores en consola.
  • Modelo 3D. Ejecuta blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Escribe un GLB de 27 KB, de unos 9 cm de ancho, reimportado y verificado.
  • Escenas y --eyes-off. Una escena que pose a Claude en tiempo de construcción debe volver a posarlo dentro de pose(f); --eyes-off solo surte efecto allí (ver stills/director_hero).

Puertas de calidad (tools/qa_loop.py)

FAIL:

  • Número incorrecto de fotogramas.
  • Una costura: el paso del último fotograma al primero es mayor que el percentil 90 de los pasos normales.

WARN:

  • Fotogramas consecutivos idénticos (una pausa muerta).
  • Movimiento por debajo del 0.8 % del brillo medio. Medido [M]: referencias r2/r3/r4 1.65/1.97/1.07 %, claude_isla 0.89 %, claude_fogata 1.66 %.

El QA no puede juzgar el gusto, la actuación ni el encuadre. Esos se verifican a ojo en imágenes fijas y tiras.

Errores conocidos (references/KNOWN_ERRORS.md)

Los que cuestan un rerenderizado:

  • Un brazo levantado más de unos 70° se esconde al lado del cuerpo.
  • La emisión brillante se lava a blanco bajo AgX: usa flame_mat.
  • Una clave lateral deja la cara frontal oscura.
  • Una escena nocturna medida con niveles de gris absolutos se ve "demasiado tranquila".
  • Un arco de fondo curvo que es demasiado estrecho muestra su borde.

Individual skills in this repo

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

Skills relacionados