Communitygithub.com

toy-loops

Créez des animations 3D en boucle parfaites (GIF et MP4), des images hero web et des pièces web vivantes (les yeux de Claude suivant le curseur) dans un style papier-diorama jouet, entièrement construites en Python et rendues dans Blender, animées avec les principes d'animation classiques (anticipation, écrasement-étirement, suivi, dépassement). Utilisez-le quand Pimbo demande un GIF, une boucle, un jouet, une animation en papier ou diorama, une animation de Claude, une image hero, des yeux qui suivent la souris, ou le modèle 3D de Claude.

Qu'est-ce que toy-loops ?

Ce skill permet de créer des mondes en papier-craft miniatures (île, camping, plateau de tournage) avec Claude comme acteur principal, dans un style chaleureux et peu profond, semblable à un jouet. Chaque objet est généré par du code Python et chaque image est calculée à partir de son numéro, garantissant une boucle parfaitement fermée. Le rendu est effectué dans Blender avec des matériaux papier, des bords biseautés blancs, et une lumière chaude et douce. Il supporte la création d'animations en boucle (GIF et MP4), d'images hero web (2400x1200), et de pièces web interactives où les yeux de Claude suivent le curseur de la souris (yeux SVG en perspective, avec un ressort sous-amorti et des clignements aléatoires). Le skill inclut des outils de QA automatisés (vérification de la couture de boucle, des images identiques, du mouvement) et une pipeline complète allant de l'idée à la livraison (rendu, encodage, test, copie des fichiers finaux). Les règles d'animation sont rigoureuses : animation pure par fonctions, pas d'état entre les images, utilisation des principes classiques (anticipation, squash & stretch, chevauchement).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait toy-loops ?

Petits mondes en papier-craft (une île, un camping, un plateau de cinéma), Claude en acteur, une lumière chaude et douce et une faible profondeur de champ comme un miniature. Chaque objet est construit à partir de code et chaque image est calculée à partir de son numéro, donc une boucle se ferme exactement. Le look a été étudié à partir des références de Pimbo dans anymation/3d_ref/style2 avec la compétence reference-video-analysis (premier passage : 3d_ref/style2/analysis/FIRST_PASS.md). Ces références sont des supports d'étude privés : copiez le savoir-faire, jamais leurs scènes.

Statut : v1, 2026-11-18. Pièces réalisées avec et vérifiées :

  • claude_isla : approuvée par Pimbo ("esta épica").
  • claude_fogata : la deuxième boucle.
  • director_hero : une image hero web 2400x1200, réalisée en deux colorations.
  • claude_pose : le découpage avec des yeux web en direct.
  • claude.glb : le modèle 3D.

Où tout se trouve

Le code est un dossier sur le PC de Pimbo : C:\Users\Pimbo\work\anymation\toy3d\skill. Chaque chemin ci-dessous est relatif à son dossier kit/ sauf indication contraire.

CheminCe que c'est
lib/toy.pyLe look : matériaux papier avec bords biseautés blancs, formes, lumière, caméra, paramètres de rendu
lib/anim.pyLes outils de l'animateur : easings, Track (pose à pose), ressorts, squash, arc, looped
lib/chars.pyClaude : le rig et ses six jeux d'yeux ; .pose(...) une fois par image
lib/runner.pyRendu d'une scène image par image ; chaque scène se termine par runner.run(...)
loops/<nom>/scene.pyUne animation en boucle
stills/<nom>/scene.pyUne image fixe (T = 1)
tools/make_loop.pyRendu, encodage GIF 1080/720 et MP4 x1/x3, QA, planche contact, en une commande
tools/qa_loop.pyCouture de boucle, nombre d'images, arrêts morts, mouvement comparé aux références
tools/duotone.pyVersion monochrome bleue d'une image (style hero web)
tools/web_eyes.pyUne page web où les yeux de Claude suivent le curseur, à partir d'un rendu sans yeux
tools/claude_glb.pyLe modèle Claude en .glb (couleurs plates, bords blancs conservés), à exécuter dans Blender
out/<nom>/Sortie : frames/, les fichiers, sheet.jpg, qa.json

Les pièces terminées sont copiées dans anymation/toy3d/videos/<nom>/ ; les pièces web vivent dans anymation/toy3d/web/.

Nécessite :

  • Blender 5.2 : la copie portable de Pimbo se trouve dans anymation/tools/blender ; ailleurs définissez $BLENDER ou mettez blender dans le PATH.
  • ffmpeg dans le PATH.
  • Python avec numpy et Pillow, pour les outils.

Pimbo n'exécute pas de scripts : vous les exécutez et lui montrez les images.

Règles qui ne plient pas

  1. Montrer avant de construire. Avant un nouveau monde ou personnage, effectuez le rendu de 2-3 images fixes (--frames ... --scale 0.5) et laissez Pimbo choisir. Regardez chaque image vous-même avant de la montrer.
  2. pose(f) est une fonction pure de l'image. Pas d'état transporté entre les images, pas de nombres aléatoires sans un germe fixe, chaque mouvement périodique doit avoir un nombre entier de cycles par boucle. Les effets qui traversent la fin de la boucle utilisent looped().
  3. Animez comme un animateur (references/ANIMATION.md). Écrivez d'abord une feuille de dopage, puis utilisez des poses clés avec des easings. Utilisez l'anticipation avant chaque action, l'écrasement à l'impact et l'étirement à la vitesse, le chevauchement sur les bras, et les échanges d'yeux sur une image. Ne déplacez jamais un corps linéairement.
  4. Une boucle n'est terminée que lorsque le QA passe (make_loop.py affiche PASS/FAIL) et que vous avez regardé une bande image par image de chaque action (voir "Bandes" ci-dessous).
  5. Dites ce qui a été mesuré [M], vu [V] et supposé [S].

Pipeline

ÉtapeQuoiCommande (depuis kit/)
1Idée : lieu, une petite histoire avec un début et un retour en boucle ; 6-9 sparler à Pimbo
2Copier la scène la plus proche : loops/claude_isla (jour, extérieur) ou loops/claude_fogata (nuit, accessoires, effets)
3Construire le décor, placer Claude, éclairage et caméra ; regarder les images fixespython tools/make_loop.py <nom> --frames 0 --scale 0.5
4Commentaire de feuille de dopage, puis les Tracks ; rendu des poses cléspython tools/make_loop.py <nom> --frames 44,62,66,71,77,81
5Aperçu rapide de la boucle entièrepython tools/make_loop.py <nom> --preview (toutes les 8 images)
6Rendu complet + GIF + MP4 + QApython tools/make_loop.py <nom>
7Bandes de chaque action, correction, re-renduvoir "Bandes" ci-dessous
8Copier les fichiers terminés dans anymation/toy3d/videos/<nom>/ et les envoyer à Pimbo

Temporisations sur le PC de Pimbo (RX 6800 XT) [M] :

  • EEVEE : environ 0,7 s par image 1080x1080, donc une boucle de 200 images prend environ 2,5 minutes.
  • Cycles : environ 10 s par image et donne un résultat presque identique. Utilisez-le uniquement pour les images fixes : --engine cycles --samples 256 prend environ 20 s en 2400x1200.

Bandes. Pour regarder une action image par image :

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

Le look, en bref (détails et chiffres : references/LOOK.md)

  • Échelle jouet. 1 unité = 1 m et Claude mesure environ 9 cm de large. La profondeur de champ réelle de la caméra (70 mm, f/4,5-7) donne alors le flou miniature par elle-même.
  • Papier. Chaque solide reçoit paper(...) : couleur mate, bosse de fibre, taches douces. Les bords biseautés reçoivent le matériau à bord blanc automatiquement (box, prism, disc).
  • Couleur. Transformation de vue AgX avec le look Punchy. Exposition -1 pour le jour et environ -0,35 pour la nuit.
    • Faces éclairées : les faces éclairées de Claude mesurent près des références (nôtre #DA8D6C, références #EC815B).
    • Luminosité : les images de jour ont une luminosité moyenne de 120-140 (références 91-181).
  • Lumière. Une clé chaude, haute et devant, de sorte que la face supérieure soit plus brillante que l'avant. Ajoutez une faible lumière de remplissage froide et une lumière de bord chaude. Les choses lumineuses (flammes, étoiles, bouffées) utilisent flame_mat et no_shadow.
  • Caméra. Reste immobile dans les boucles (les références ne déplacent la caméra que pour un cut ou un push-in).
    • Carré 1080 pour les GIF.
    • Les hero sont larges, avec shift_x poussant le sujet au tiers.

Claude, en bref (references/CHARACTERS.md)

claude = Claude('claude', loc), puis une fois par image :

claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
  • Yeux : sq, happy (^ ^), line (- -), squeeze (> <), dot (. .), sad.
  • Accessoires : un accessoire tenu est parenté à claude.hand(side).
  • Agitation : le bras qui agite doit être celui faisant face à la caméra.

Pièces web : yeux en direct et modèle 3D

  • Yeux en direct.
    1. Effectuez le rendu avec --eyes-off (et --transparent pour un découpage) : python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. Le runner cache les yeux et écrit eyes.json : le centre pixel de chaque œil et les axes du visage en pixels par mm.
    2. Exécutez python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render with eyes>. Il écrit index.html plus un fichier unique <dir>_un_archivo.html.
    3. Ce que fait la page :
      • Les yeux sont des formes SVG dessinées sur le plan du visage, donc la perspective est correcte même sur un visage incliné.
      • Ils suivent le pointeur avec un ressort sous-amorti et clignent toutes les 2,5 à 5,5 s.
      • ^ ^ lorsque le pointeur est proche, > < lorsqu'on appuie.
      • Un rebond écrasement-étirement au clic (pas avec --hero, qui laisse une image complète immobile).
    4. Testé dans Chrome via playwright (pointeur gauche, droite, haut, bas, proche, appui, relâchement) : aucune erreur dans la console.
  • Modèle 3D. Exécutez blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Il écrit un GLB de 27 Ko, environ 9 cm de large, réimporté et vérifié.
  • Scènes et --eyes-off. Une scène qui pose Claude au moment de la construction doit le reposer à l'intérieur de pose(f) ; --eyes-off ne prend effet que là (voir stills/director_hero).

Contrôles qualité (tools/qa_loop.py)

FAIL :

  • Nombre d'images incorrect.
  • Une couture : le pas de la dernière image à la première est plus grand que le 90ème percentile des pas normaux.

WARN :

  • Images consécutives identiques (un arrêt mort).
  • Mouvement inférieur à 0,8 % de la luminosité moyenne. Mesuré [M] : références r2/r3/r4 1,65/1,97/1,07 %, claude_isla 0,89 %, claude_fogata 1,66 %.

Le QA ne peut pas juger le goût, le jeu d'acteur ou le cadrage. Ceux-ci sont vérifiés à l'œil sur les images fixes et les bandes.

Erreurs connues (references/KNOWN_ERRORS.md)

Celles qui coûtent un re-rendu :

  • Un bras levé au-dessus d'environ 70° se cache à côté du corps.
  • Une émission brillante blanchit sous AgX : utilisez flame_mat.
  • Une clé latérale laisse la face avant sombre.
  • Une scène de nuit mesurée avec des niveaux de gris absolus semble "trop calme".
  • Un arc de fond incurvé trop étroit montre son bord.

Individual skills in this repo

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

Skills associés