Communitygithub.com

dsauce/stickman-kino

Animieren Sie einen Stickman-Kino-Film – schreiben Sie scenes.js aus film.json/Storyboard mit der Stickman-Engine (rigged Strichmännchen mit 58 Posen und IK, ~190 Requisiten, Diagramme, kinetischer Text, Untertitel, Kamerafahrten, Effekte, Umgebungen, Themen, Übergänge), synchron zur Sprachaufnahme, dann mit check + Snapshots prüfen.

Was ist stickman-kino?

Dieses Skill ermöglicht es einem KI-Agenten, visuelle Animationen für einen Stickman-Kino-Film zu erstellen, indem es die Datei `scenes.js` schreibt, die auf einem `film.json`-Storyboard basiert. Es verwendet die `SM`-Engine, eine globale JavaScript-Bibliothek, die im Browser läuft. Der Skill deckt die gesamte Bandbreite der Filmproduktion ab: von der Positionierung von Strichmännchen (mit 58 vordefinierten Posen, inverser Kinematik und Geh-/Laufanimationen) über die Platzierung von etwa 190 Requisiten bis hin zu Diagrammen, Charts, kinetischem Text und Kamerafahrten. Die Synchronisation mit der Sprachaufnahme erfolgt über `sc.cue()`, das die geschätzte Zeit eines gesprochenen Wortes zurückgibt. Der Skill betont eine iterative Qualitätssicherung: Nach dem Schreiben der Szene muss der Befehl `stickman check` fehlerfrei durchlaufen, und `stickman snapshot` erzeugt visuelle Prüfungen, die auf Überlappungen, Überlagerungen, abgeschnittene Elemente oder falsche Farben hin überprüft werden müssen. Der Skill ist für Plattformen wie Claude Code, Cursor und andere KI-Coding-Tools konzipiert, die mit Node.js-Befehlen interagieren und JavaScript-Code generieren können. Er enthält ausführliche Regeln für gutes visuelles Storytelling (z. B. alle 2–3 Sekunden eine Änderung, Figuren sollen agieren statt nur stehen, Akzente tragen Bedeutung) und praktische Hinweise zu Koordinaten, Ebenen und Zeitleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsauce/stickman-kino/tree/HEAD/skills/stickman-animator

In Ihrer bevorzugten KI fragen

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

Dokumentation

Stickman-Animator

Sie schreiben scenes.js – einen film.scene(id, sc => { … }) pro Clip in film.json, gleiche IDs, gleiche Reihenfolge. Alles ist einfaches Browser-JS gegen die globale SM-Engine. Lesen Sie references/api.md (vollständige Übersicht) und references/cookbook.md (Copy-Paste-Rezepte), bevor Sie schreiben.

Gedankenmodell

  • Lokale Zeit. Innerhalb einer Szene ist jede Zeit in Sekunden ab dem Start des Clips. sc.dur = Cliplänge.
  • Verkettbar. Jede Aktion gibt die Zeit zurück, zu der sie endet: const t = bob.walkTo(900, 0.2); bob.wave(t);
  • Sprachsynchron. sc.cue("Wort") = geschätzte lokale Zeit, zu der der Sprecher das Wort sagt (sc.cue(["Wort", 1]) = zweites Vorkommen, sc.cue(0.5) = Mitte der Sprachaufnahme). Setzen Sie die Visualisierung auf oder kurz vor das Wort (sc.cue("Idee") - 0.15).
  • Ebenen. world (Umgebung) → back (Requisiten) → Figuren → front (Requisiten über Figuren) → ui (Bildschirmbereich, ignoriert Kamera) → top (Übergänge). Übergeben Sie { layer: "front" } / "ui" bei Requisiten.
  • Koordinaten. Die Leinwand ist sc.W × sc.H (1920×1080, 1080×1920 oder 1080×1080). sc.groundY ist der Boden (80 % unten im Querformat, 74 % im Hochformat). Figuren stehen mit y = ihren Füßen.
  • Dinge. Requisiten, Text, Diagramme, Formen sind Things: .pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show.
  • Versteckt bis zum Auftritt. Erstellen mit { hidden: true } dann .pop(t); Text ist versteckt bis .in(t, fx).

Szenen-Gerüst

const film = SM.film();                       // Thema/Format kommen aus film.json

film.scene("hook", sc => {
  sc.enter("fade");                           // optional, zum vorherigen Exit passend
  sc.ground();                                // Bodenlinie (Stil: "grass" | "none")
  const bob = sc.figure({ x: -150, face: "dots" });        // oder sc.character("zeke", {...})
  const t1 = bob.walkTo(sc.W * 0.35, 0.2);
  bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("dieses"));
  const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
  chart.grow(sc.cue("wuchs"));
  sc.text("Umsatz [verdoppelt]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("verdoppelt") - 0.1, "words");
  sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3);   // langsamer Push
  sc.exit("wipe-left");
});

Intros & Outros

Clips, die "intro" / "outro" in film.json deklarieren, bauen sich selbst. Sie brauchen dafür keine Szene. Um Extras hinzuzufügen (Requisiten, die um den Titel herumplatzen, eine Figur, die zum CTA winkt), schreiben Sie die Szene und rufen das Preset selbst auf; die automatische Version wird dann übersprungen:

film.scene("intro", sc => {
  const t = sc.intro("countdown", sc.clip.intro);          // gibt zurück, wann der Titel gelandet ist
  sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
  sc.exit("wipe-left");
});
film.scene("outro", sc => {
  sc.enter("fade", { color: "bg" });
  sc.outro("kino", sc.clip.outro);
  sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});

Regeln für die Inszenierung (was es gut aussehen lässt)

  1. Alle 2–3 s ändert sich etwas. Planen Sie 3 Beats pro Clip; füllen Sie Lücken mit einem Kamerapush, einem Blinzeln/Nicken, einem Requisiten-Wackeln, einer Hervorhebung.
  2. Bühne vor der Animation. Entscheiden Sie, wo die Figur, die Hauptrequisite und der Text leben (Drittel bei 16:9; gestapelt bei 9:16). Halten Sie Text vom Kopf der Figur und von anderem Text fern.
  3. Figuren agieren, nicht stehen. Verwenden Sie Gesten, die etwas bedeuten: point auf das Besprochene, think vor einer Idee, surprise bei einer Enthüllung, shrug bei einem Mythos, celebrate bei einem Erfolg, push/climb/runTo für Anstrengung.
  4. Ein fokaler Auftritt nach dem anderen; staffeln Sie um 0.1–0.2 s, wenn mehrere Dinge erscheinen.
  5. Passen Sie Exits und Entrances zwischen Clips an (gleicher Übergangstyp) oder Match-Cut (gleiche Pose/Objektposition).
  6. Akzente tragen Bedeutung: "a1" Problem, "a2" Lösung, "a3" Belohnung. Übergeben Sie Farbnamen: "a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper" oder Hex.
  7. Bodenwahrheit: Figuren stehen auf sc.groundY (oder einer von Ihnen berechneten Oberfläche); Requisiten, die auf dem Boden ruhen, verwenden y = sc.groundY - size*0.4.
  8. Hochformat: Figur size: 420-460, Requisiten 200-300, Text 70-120, halten Sie das mittlere Band belebt und Untertitel tief.

Überprüfen (obligatorische Schleife)

  1. stickman check <verz> → muss Check passed ausgeben. page_error = Ihr JS hat einen Fehler ausgelöst; beheben Sie ihn.
  2. stickman snapshot <verz> (oder --at zu Schlüsselzeitpunkten) → öffnen Sie snapshots/contact-sheet*.jpg und die PNGs und schauen Sie. Korrigieren Sie: Abschneiden, Überlappungen, schwebende Figuren, leere Momente, unleserlichen Text, Arme durch Köpfe (Posen-Overrides anpassen), falsche Akzentfarben.
  3. Wiederholen, bis alles sauber ist, dann rendern.

Fallstricke

  • Planen Sie jede Figur chronologisch. celebrate() plant eine Rückkehr zu stand bei +1.0 s; übergeben Sie { hold: true }, wenn Sie kurz danach wieder posieren.
  • bob.hold(prop) befestigt an der rechten Hand und bleibt aufrecht; vor Gebrauch erstellen und .pop(t) darauf.
  • Text-Markup: "[akzentuierte Wörter]" färbt eine Phrase mit der accent-Option (Standard a2).
  • Diagramme zählen Zahlen mit diskreten Schritten; geben Sie prefix/suffix/decimals in den Diagrammoptionen an.
  • Verwenden Sie nicht Math.random/Date/setTimeout. Verwenden Sie SM.rng(seed).
  • Rohes GSAP ist erlaubt: sc.tl.to(el, vars, sc.T(localTime)) – halten Sie es als reine Funktion der Zeit.

Verwandte Skills