Communitygithub.com

toy-loops

Erstelle nahtlose 3D-Animationen im Schleifenformat (GIF und MP4), Web-Heldenbilder und interaktive Live-Web-Stücke (Claudes Augen folgen dem Cursor) im Spielzeug-Papier-Diorama-Look, vollständig aus Python gebaut und in Blender gerendert, animiert mit den klassischen Animationsprinzipien (Antizipation, Quetschen und Strecken, Nachziehen, Überschießen).

Was ist toy-loops?

Diese Fähigkeit (Skill) ermöglicht die Erstellung von charmanten, nahtlosen 3D-Animationen und Standbildern im Stil eines Papier-Dioramas. Der Fokus liegt auf einem einheitlichen, miniaturhaften Look mit warmem Licht, geringer Schärfentiefe und der Verwendung des Claude-Charakters als Schauspieler. Der gesamte Prozess – vom Modellbau über die Beleuchtung bis zur Animation – erfolgt programmatisch mit Python und wird in Blender gerendert. Die Fähigkeit legt großen Wert auf klassische Animationsprinzipien (Antizipation, Quetschen und Strecken) und bietet Werkzeuge zur Qualitätssicherung, um makellose Schleifen zu gewährleisten. Sie unterstützt die Erstellung von Bildern (Stills), GIFs, MP4s und interaktiven Web-Komponenten, bei denen Claudes Augen der Maus folgen. Die Entwicklungsumgebung ist speziell auf die Workstation des Nutzers zugeschnitten und erfordert Blender, FFmpeg und Python mit numpy und Pillow. Ein besonderes Merkmal ist die Betonung der Zusammenarbeit mit dem Nutzer (Pimbo): Neues wird zuerst als Vorschau gezeigt, und die gesamte Animation muss strenge Qualitätsprüfungen bestehen, bevor sie als fertig gilt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht toy-loops?

Kleine Papier-Bastelwelten (eine Insel, ein Campingplatz, ein Filmset), Claude als Schauspieler, sanftes warmes Licht und eine geringe Schärfentiefe wie bei einer Miniatur. Jedes Objekt wird aus Code gebaut und jeder Frame aus seiner Nummer berechnet, sodass eine Schleife exakt schließt. Der Look wurde aus Pimbos Referenzen in anymation/3d_ref/style2 mit dem Skill reference-video-analysis studiert (erster Durchlauf: 3d_ref/style2/analysis/FIRST_PASS.md). Diese Referenzen sind privates Studienmaterial: Kopiere die Bauweise, niemals ihre Szenen.

Status: v1, 2026-11-18. Damit erstellte und geprüfte Stücke:

  • claude_isla: von Pimbo genehmigt ("esta épica").
  • claude_fogata: die zweite Schleife.
  • director_hero: ein 2400x1200 Web-Heldenbild, in zwei Farbgebungen.
  • claude_pose: der Ausschnitt mit Live-Web-Augen.
  • claude.glb: das 3D-Modell.

Wo alles lebt

Der Code befindet sich in einem Ordner auf Pimbos PC: C:\Users\Pimbo\work\anymation\toy3d\skill. Alle folgenden Pfade sind relativ zum kit/-Unterordner, sofern nicht anders angegeben.

PfadWas es ist
lib/toy.pyDer Look: Papiermaterialien mit weißen Facettenkanten, Formen, Licht, Kamera, Render-Einstellungen
lib/anim.pyDie Werkzeuge des Animators: Easing-Funktionen, Track (Pose zu Pose), Federn, squash, arc, looped
lib/chars.pyClaude: das Rig und seine sechs Augensets; .pose(...) einmal pro Frame
lib/runner.pyRendert eine Szene Frame für Frame; jede Szene endet mit runner.run(...)
loops/<name>/scene.pyEine sich wiederholende Animation
stills/<name>/scene.pyEin Standbild (T = 1)
tools/make_loop.pyRendern, GIF 1080/720 und MP4 x1/x3 codieren, Qualitätssicherung, Kontaktbogen, mit einem Befehl
tools/qa_loop.pySchleifennaht, Framanzahl, Stillstände, Bewegung im Vergleich zu den Referenzen
tools/duotone.pyBlaue Monochrom-Version eines Bildes (Web-Heldenstil)
tools/web_eyes.pyEine Webseite, auf der Claudes Augen dem Cursor folgen, basierend auf einem Render ohne Augen
tools/claude_glb.pyDas Claude-Modell als .glb (flache Farben, weiße Kanten erhalten), ausgeführt in Blender
out/<name>/Ausgabe: frames/, die Dateien, sheet.jpg, qa.json

Fertige Stücke werden nach anymation/toy3d/videos/<name>/ kopiert; Web-Stücke befinden sich in anymation/toy3d/web/.

Erfordert:

  • Blender 5.2: Pimbos portable Kopie ist unter anymation/tools/blender; an anderer Stelle setze $BLENDER oder füge blender zum PATH hinzu.
  • ffmpeg im PATH.
  • Python mit numpy und Pillow, für die Werkzeuge.

Pimbo führt keine Skripte aus: Du führst sie aus und zeigst ihm Bilder.

Unveränderliche Regeln

  1. Zeigen vor dem Bauen. Vor einer neuen Welt oder Figur rendere 2-3 Standbilder (--frames ... --scale 0.5) und lass Pimbo wählen. Sieh dir jedes Bild selbst an, bevor du es zeigst.
  2. pose(f) ist eine reine Funktion des Frames. Kein Zustand zwischen Frames, keine Zufallszahlen ohne festen Samen, jede periodische Bewegung eine ganze Anzahl von Zyklen pro Schleife. Effekte, die das Schleifenende überqueren, verwenden looped().
  3. Animiere wie ein Animator (references/ANIMATION.md). Schreibe zuerst ein Dope Sheet, dann verwende Key-Posen mit Easing. Verwende Antizipation vor jeder Aktion, Quetschen beim Aufprall und Strecken bei Geschwindigkeit, Überlappung bei Armen und einen Frame lange Augenwechsel. Bewege niemals einen Körper linear.
  4. Eine Schleife ist erst fertig, wenn die Qualitätssicherung bestanden ist (make_loop.py gibt PASS/FAIL aus) und du einen Frame-für-Frame-Streifen jeder Aktion angesehen hast (siehe "Streifen" unten).
  5. Gib an, was gemessen [M], gesehen [V] und angenommen [S] wurde.

Pipeline

SchrittWasBefehl (von kit/ aus)
1Idee: Ort, eine kleine Geschichte mit Anfang und Rückkehr zur Schleife; 6-9 smit Pimbo sprechen
2Kopiere die ähnlichste Szene: loops/claude_isla (Tag, draußen) oder loops/claude_fogata (Nacht, Requisiten, Effekte)
3Baue das Set, platziere Claude, Licht und Kamera; betrachte Standbilderpython tools/make_loop.py <name> --frames 0 --scale 0.5
4Dope-Sheet-Kommentar, dann die Tracks; rendere die Key-Posenpython tools/make_loop.py <name> --frames 44,62,66,71,77,81
5Schneller Blick auf die gesamte Schleifepython tools/make_loop.py <name> --preview (jeder 8. Frame)
6Vollständiges Rendern + GIF + MP4 + Qualitätssicherungpython tools/make_loop.py <name>
7Streifen jeder Aktion, korrigieren, neu rendernsiehe "Streifen" unten
8Kopiere die fertigen Dateien nach anymation/toy3d/videos/<name>/ und sende sie an Pimbo

Zeiten auf Pimbos PC (RX 6800 XT) [M]:

  • EEVEE: ca. 0,7 s pro 1080x1080 Frame, daher dauert eine 200-Frame-Schleife etwa 2,5 Minuten.
  • Cycles: ca. 10 s pro Frame und sieht fast gleich aus. Verwende es nur für Standbilder: --engine cycles --samples 256 dauert etwa 20 s bei 2400x1200.

Streifen. Um eine Aktion Frame für Frame zu betrachten:

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

Look, kurzgefasst (Details und Zahlen: references/LOOK.md)

  • Spielzeugmaßstab. 1 Einheit = 1 m und Claude ist etwa 9 cm breit. Die echte Kameratiefenschärfe (70 mm, f/4,5-7) erzeugt dann automatisch die Miniaturunschärfe.
  • Papier. Jeder Festkörper bekommt paper(...): matte Farbe, Faserstruktur, weiche Flecken. Facettenkanten erhalten automatisch das Weißkanten-Material (box, prism, disc).
  • Farbe. View-Transformation AgX mit dem Punchy-Look. Belichtung -1 für Tag und etwa -0,35 für Nacht.
    • Beleuchtete Flächen: Claudes beleuchtete Flächen messen nahe an den Referenzen (unsere #DA8D6C, Referenzen #EC815B).
    • Helligkeit: Tag-Frames haben eine mittlere Helligkeit von 120-140 (Referenzen 91-181).
  • Licht. Ein warmes Key-Licht, hoch und von vorne, sodass die Oberseite heller ist als die Vorderseite. Füge ein schwaches kühles Fülllicht und einen warmen Randlicht hinzu. Leuchtende Dinge (Flammen, Sterne, Wölkchen) verwenden flame_mat und no_shadow.
  • Kamera. Steht still in Schleifen (die Referenzen bewegen die Kamera nur für einen Schnitt oder eine Kamerafahrt).
    • Quadratisch 1080 für GIFs.
    • Heldenbilder sind breit, mit shift_x, das das Motiv in das erste Drittel schiebt.

Claude, kurzgefasst (references/CHARACTERS.md)

claude = Claude('claude', loc), dann einmal pro Frame:

claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
  • Augen: sq, happy (^ ^), line (- -), squeeze (> <), dot (. .), sad.
  • Requisiten: Eine gehaltene Requisite ist an claude.hand(side) Eltern-gebunden.
  • Winken: Der winkende Arm muss der sein, der der Kamera zugewandt ist.

Web-Stücke: Live-Augen und das 3D-Modell

  • Live-Augen.
    1. Rendere mit --eyes-off (und --transparent für einen Ausschnitt): python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. Der Runner versteckt die Augen und schreibt eyes.json: den Pixelmittelpunkt jedes Auges und die Gesichtsachsen in Pixeln pro mm.
    2. Führe aus: python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render mit augen>. Es schreibt index.html plus eine Einzeldatei <dir>_un_archivo.html.
    3. Was die Seite tut:
      • Die Augen sind SVG-Formen, die auf die Gesichtsebene gezeichnet werden, sodass die Perspektive auch bei geneigtem Gesicht stimmt.
      • Sie folgen dem Zeiger mit einer unterdämpften Feder und blinzeln alle 2,5-5,5 s.
      • ^ ^ wenn der Zeiger nahe ist, > < während des Drückens.
      • Ein Quetsch-und-Streck-Sprung beim Klick (nicht mit --hero, das ein vollständiges Bild still hält).
    4. Getestet in Chrome via Playwright (Zeiger links, rechts, oben, unten, nah, drücken, loslassen): keine Konsolenfehler.
  • 3D-Modell. Führe aus: blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]. Es schreibt ein 27 KB GLB, etwa 9 cm breit, erneut importiert und überprüft.
  • Szenen und --eyes-off. Eine Szene, die Claude zur Bauzeit posiert, muss sie erneut innerhalb von pose(f) posieren; --eyes-off wirkt nur dort (siehe stills/director_hero).

Qualitätsprüfungen (tools/qa_loop.py)

FEHLER:

  • Falsche Frame-Anzahl.
  • Eine Naht: Der Schritt vom letzten Frame zum ersten ist größer als das 90. Perzentil der normalen Schritte.

WARNUNG:

  • Identische aufeinanderfolgende Frames (ein Stillstand).
  • Bewegung unter 0,8 % der mittleren Helligkeit. Gemessen [M]: Referenzen r2/r3/r4 1,65/1,97/1,07 %, claude_isla 0,89 %, claude_fogata 1,66 %.

Die Qualitätssicherung kann Geschmack, schauspielerische Leistung oder Bildausschnitt nicht beurteilen. Diese werden durch Augenschein an Standbildern und Streifen geprüft.

Bekannte Fehler (references/KNOWN_ERRORS.md)

Die Fehler, die ein erneutes Rendern erfordern:

  • Ein Arm, der über etwa 70° angehoben wird, versteckt sich neben dem Körper.
  • Helle Emissionen bleichen unter AgX zu Weiß aus: verwende flame_mat.
  • Ein seitliches Key-Licht lässt die Vorderseite dunkel.
  • Eine Nachtszene, gemessen mit absoluten Graustufen, wirkt "zu ruhig".

Individual skills in this repo

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

Verwandte Skills