Communitygithub.com

cinematicanimation

Zeigt einem Agenten, wie man „cinematicanimation“ plant, baut oder schneidet, sodass das konkrete Output verwendbarer Text oder ein Drehbuch ist. Der Ablauf durchläuft den Look in sechs Zeilen, Engine: Cycles oder EEVEE, Pipeline. Verwende es, wenn ein neuer Auftrag dieses Handwerk erfordert.

Was ist cinematicanimation?

Diese Fähigkeit leitet KI-Agenten an, hochwertige Filmanimationen in Blender zu erstellen, die sich durch eine filmische, stimmungsvolle Ästhetik auszeichnen – mit wenigen Charakteren, dunklen Räumen, einer einzigen sichtbaren Lampe und einer Geschichte, die auch ohne Ton funktioniert. Der Agent lernt, zwischen Cycles (Referenz-Look) und EEVEE (schnellere Renderzeit bei Einhaltung bestimmter Regeln) zu wählen und folgt einer klaren sechsstufigen Pipeline von der Kurzbeschreibung bis zur Endbearbeitung. Die Pipeline umfasst definierte „Gates“ (Briefing, Look, Schnitt), die sicherstellen, dass jedes Bild die gewünschten Helligkeits-, Farb- und Timing-Vorgaben erfüllt. Die Fähigkeit ist für Blender 5.1 optimiert, unterstützt aber auch andere Engines, und bietet umfangreiche Hilfsfunktionen (cine_kit) für Szenenaufbau, Beleuchtung, Charakter-Rigging und Kameraarbeit. Ziel ist die Produktion einsatzbereiter Clips, die sowohl in sozialen Medien (Reels) als auch als eigenständige Kurzfilme fungieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aaksa/cinematicanimation/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht cinematicanimation?

Die Premium-Spur neben robloxmaxxing. Jene Fähigkeit erstellt Spiel-Assets und helle, belebte Erklärwelten. Diese hier macht einen Film: wenige Charaktere, dunkle Räume, eine Lampe, eine Geschichte, der man auch ohne Ton folgen kann, gerendert in Cycles (der Referenz-Look) oder EEVEE (derselbe Look in einem Bruchteil der Zeit, mit den Regeln unter „Engine“ unten).

SKILL = dieser Ordner. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = Blenders Python (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), nur für beatgrid.py benötigt. Andere Skripte: python3 -I.

Einmal pro Sitzung lesen: references/craft.md (Geschichte, Einstellungen, Schnitt, Animation, Ton) und references/look.md (Licht, Materialien, Objektiv, Grading, Renderzeit). references/reference-films.md ist der Beleg: beide Filme Einstellung für Einstellung gemessen. Lies es, bevor du mit einer Zahl in dieser Datei argumentierst.

Der Look in sechs Zeilen

  1. Spielzeug-Charaktere, echte Welt. Blöcke mit gemalten Gesichtern; alles um sie herum fotorealistisch, abgenutzt und im kleinen Maßstab.
  2. Dunkel. Mittlere Bildhelligkeit 0,10-0,26 des vollen Bereichs. Eine sichtbare Lampe ist das Hauptlicht. Kein Fülllicht, kein Himmel.
  3. Prop-Höhe. Die Kamera sitzt auf Tischhöhe, nah, mit geringer Schärfentiefe und etwas Weichem im Vordergrund.
  4. Einstellungen tragen die Geschichte. Hände, Objekte, lesbare Requisiten. Etwa die Hälfte der Einstellungen zeigt kein Gesicht.
  5. Schnitt auf dem Raster. Einstellungslängen sind ganze oder halbe Taktschläge der Musik. Das Tempo ändert sich mit der Geschichte.
  6. Stille ist eine Einstellung. Die Musik stoppt einmal, am Wendepunkt. Das Ende ist ein Gesicht oder ein Objekt, dann Schwarz.

Engine: Cycles oder EEVEE

K.setup(..., engine="CYCLES" | "EEVEE"). Gemessen auf einem M4 bei 1080x1920:

Enginepro Bildeine 60 s Sequenz (1.440 Bilder, zwei Prozesse)verwenden, wenn
Cycles, 160 Samples70-90 s28-36 hein Helden-Still, ein Cover, ein kurzer Teaser
Cycles, 16 Samples, 40 % Größe11 s2 h (weich: eine Vorschau, keine Auslieferung)zum Überprüfen eines Schnitts
EEVEE, 64 Samples, volle Größe, nur der eigene Set geladen6-8 s1-1,5 hdie Auslieferung von etwas länger als ~15 s

EEVEE hält den Look (Dunst, Bokeh, hinterleuchteter Kunststoff, AgX) wenn diese Regeln eingehalten werden. Jede kostete eine Runde auf Negara Angin:

  • Rufe K.eevee_lights(keep=(...)) auf, nachdem die Szene gebaut ist. Nur die großen motivierten Lichter werfen Schatten; viele kleine Schattenlichter überlaufen den Schatten-Pool und flackern von Bild zu Bild.
  • Eine Fensterscheibe ist Alpha, kein Glas. Transmissionsglas in EEVEE bricht den Bildschirmraum (was dahinter ist, verschmiert) und gemischte Transmission rendert schwarz. Verwende Principled Alpha ~0,14, surface_render_method = "BLENDED", fällt durch Reflection + Bump.
  • EEVEE kann nicht durch eine Scheibe fokussieren. Die Schärfentiefe liest die Tiefe der nächstgelegenen Oberfläche, also wird alles hinter dem Glas so unscharf, als wäre es am Glas. Zeige die Scheibe nur, während sie das Motiv ist (K.visible), verstecke sie, sobald der Fokus daran vorbeigeht.
  • Glas wirft keinen Schatten (eevee_lights regelt das): EEVEE behandelt es als undurchsichtig, also würde Licht durch ein Fenster oder ein Glas stoppen.
  • Rendere jede Einstellung nur mit ihrem eigenen Set geladen (--sets): Jedes geladene Set wird in jedem Bild ausgewertet (instanziierte Felder, Regen). Auf Negara Angin hat das die Zeit halbiert. Zwei Worker können dieselbe Jobliste abarbeiten; render_range beansprucht Bilder mit Sperrdateien.
  • Bewegungsunschärfe und Volumenkachelgröße kosten wenig; Samples über 64 bringen nichts, was ein Körnungsdurchgang versteckt.
  • Cycles hat Kaustiken ausgeschaltet: Licht hinter Fensterglas erreicht nie den Raum. Setze das „Fensterlicht“ in die Scheibe.

Pipeline

StufeAktionGate
0. KurzbeschreibungLogline, die Schleife oder Kette, der Einsatzgegenstand, Palette pro Ort, der Track und sein BPM (beatgrid.py)GATE B: Jede Zeile der Kurzbeschreibung ist ein beobachtbares Ding
1. EinstellungsplanEinstellungen als Zeilen: Größe, Objektiv, was sich bewegt, Länge in Taktschlägen; eine Master pro SzeneGATE S: Regeln in craft.md gelten auf dem Papier
2. Welt + Besetzungcine_kit: Raum/Straße, Requisiten, Lampen, Dunst; K.Char-FigurenStills des Masters, jedes in einem Satz beschreiben
3. LichtHauptlicht von einer sichtbaren Lampe, Akzente, Kante; still jede Kamera in Vorschau-GrößeGATE L auf dem Still jeder Einstellung (look_gate.py)
4. PerformancePosen auf Taktschlägen (hit, pose, face, talk), Kamerafahrten, life()Ein Kontaktbogen liest sich wie die Geschichte ohne Ton
5. Rendernrender_range in 2-3 Prozessen, 16-Bit-PNG, existierende überspringenBildanzahl = Filmlänge
6. Fertigstellungfinish.py (Glühen, Grading, Weichheit, Vignette, Korn) + TonmischungGATE L auf dem Film, GATE E (shotlist.py --bpm), -14 LUFS

Ein Gate, das durchfällt, wird auf seiner eigenen Stufe behoben: Ein helles Bild ist ein Beleuchtungsproblem, nie ein Grading-Problem.

GATE B - die Kurzbeschreibung (ein Docstring am Anfang des Build-Skripts)

  • Logline in einem Satz mit einem Wunsch und einem Preis.
  • Form: Eine Schleife, die kürzer wird (eine Regel wird einmal gezeigt, dann schneller wiederholt) oder eine Kette (jede Szene endet mit dem Objekt, das die nächste beginnt).
  • Der Einsatzgegenstand: Ein kleines Ding mit einem Gesicht oder einer Zahl darauf (ein Foto, eine Rechnung, ein Ticket). Wo die Kamera darauf zufährt.
  • Palette pro Ort: Eine dominante Lichtfarbe, eine Schattenfarbe, eine Akzentfarbe. Unterschiedlich für jeden Ort.
  • Ton: Der Track, sein BPM, wo die Musik einsetzt, die 3-8 s, wo sie stoppt.
  • Ende: Das letzte Bild (ein Gesicht oder ein Objekt) und das eine oder zwei Wörter auf Schwarz danach.
  • Ausschlüsse: Wie dieser Film nicht aussehen darf.

GATE L - der Look (Zahlen aus den Referenzen; scripts/look_gate.py)

Messung (0-1 des vollen Bereichs)BestehenReferenzen
Mittlere Bildhelligkeit0,10-0,260,20; 0,17
Schattenpegel (10. Perzentil-Pixel)unter 0,090,06; 0,04
Helle-Pegel (90. Perzentil-Pixel)0,22-0,560,46; 0,36
Spitze (hellstes Pixel)über 0,850,91; 0,98
Schwarzbodenunter 0,050,02; 0,02
SättigungAmber 0,10-0,30, Noir 0,03-0,140,18; 0,07

Führe es auf dem fertigen Still jeder Einstellung aus, dann auf dem gesamten Film. Eine einzelne helle Einstellung kann WARNen; ein FAIL wird behoben. „Spitze unter 0,85" bedeutet, dass es kein echtes Highlight im Bild gibt: Setze eine Lampe, einen Glanzpunkt oder eine Neonröhre, wo das Objektiv sie sehen kann.

GATE E - der Schnitt (scripts/shotlist.py film.mp4 --bpm N)

Jede Einstellungslänge ist eine ganze oder halbe Anzahl von Taktschlägen. Durchschnittliche Einstellung 1-3,5 s. Die ersten beiden Einstellungen sind die längsten ihrer Szene. Keine zwei aufeinanderfolgenden Einstellungen haben dieselbe Größe und denselben Winkel. Ein Abschnitt von 3-8 s hat keine Musik. Der Film endet innerhalb einer Sekunde nach Schwarz.

Eine Szene bauen

"$B" -b --factory-startup -P build.py -- --out out --stills        # ein Still pro Einstellung, halbe Größe, etwa 10 s pro
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final &   # starte es 2-3 Mal: vorhandene Bilder werden übersprungen
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True)            # "9:16" für ein Reel; preview=False für die Auslieferung
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()

examples/standoff/build.py ist die vollständige, getestete Version (4 Einstellungen, 7,2 s): kopiere sie als Ausgangspunkt eines neuen Films.

cine_kit in einer Tabelle

BedarfAufruf
Szenesetup(aspect, height, samples, preview), world(), room(), haze(size, loc, density)
Oberflächenplastic (Spielzeughaut, leuchtet bei Gegenlicht), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat (Filz, Putz, Metall), glass, emit (Neon, Glühbirnen, Bildschirme)
Formenbox (immer abgeschrägt), cyl, torus(arc=), text (3D-Buchstaben, Neon-Wörter), paper (Poster / Rechnung / Karte mit lesbaren Zeilen), round_table, chair
Lampenpendant (sichtbarer Schirm + Birne + Spot), neon (Röhre + passendes Fülllicht), bokeh_lights, light(kind, loc, power, color=Kelvin oder Hex, target, size)
BesetzungChar(name, skin, shirt, pants, hat=hair/cap/fedora/beanie): .pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...) (schnappen + halten), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life()
mitgelieferte CharaktereRigged("bugis_man" / "bugis_woman" / path.blend, at, yaw): ein Charaktermodell aus einer Datei, in Char-Höhe, mit denselben Pose-Kanälen wie Char (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). Gemalte Gesichter: kein Wechsel, also kommt Emotion von Kopf, Armen und dem Schnitt. Ein neues einteiliges Modell wird einmal mit scripts/rig_block.py geriggt (zuerst Hals, Hüfte und Arm-Grenze aus Schnitten messen) und zu K.CAST hinzugefügt; das Rig ist starr, außer dem Hals, den neck_blend.py weicher macht (siehe „Halsnaht")
der Avatar des BenutzersAvatar(at, yaw, pose): Aksas geriggter Roblox-Charakter (Roblox/blender/hero_face.blend) in Char-Höhe. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (Kameraziel), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, dann einmal .finish(). Der Benutzer ist der Held seiner eigenen Filme: Verwende Avatar für die Hauptrolle, es sei denn, er sagt etwas anderes, Char für alle anderen
GesichterK.EXPRESSIONS: neutral, smirk, grin, angry, shout, shock, sad, shut, talk_a, talk_o, talk_m, side. Nur Austausch, nie Morphs
Singen auf einem gemalten Gesichteinmal: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (findet den gemalten Mund auf einer orthografischen Front-Render, zeichnet einen 10-Formen-Mund-Atlas in seinen Farben über seine eigene Haut, legt eine Platte auf das Gesicht, die auf den Kopf-Knochen geskinnt ist; Zelle 0 = das Gemälde, also ist es im Ruhezustand unsichtbar; dann wird der Hals neu geblendet, sodass alles unter der Platte auf dem Kopf reitet). In der Szene: K.Rigged(".../x_sing.blend").sing(words, f0, f1) mit words = [{"word","start","end"}] aus einem Transkript des Tracks (faster-whisper Wortzeiten). Drehe den Kopf zur Linse, während sie singt: ein Profil verbirgt den Mund
KameraCam(name, loc, target, lens, stop, focus, roll): .at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount); Cam.distance_for(lens, height) = wie weit man stehen muss, um das Bild mit einem Motiv dieser Höhe zu füllen (platzieren Sie Nahkameras nach Größe, nie nach Schätzung); .clip_follow(f0, f1, subject) = getastete Nah-Clip, um über einen Kopf in das Telefon in seinen Händen zu tauchen
SichtbarkeitK.visible(ob, [(f0, f1), ...]): nur in diesen Bereichen rendern-sichtbar; berührt nur die Ausblendkurve (setze niemals jede Kurve eines Objekts auf CONSTANT: seine Bewegung wird zu Stufen)
Schnittbeats(bpm) -> Bild von Takt n; cut_list([(name, cam, beats), ...], bpm) bindet Kameras an Marker und gibt die Bilder jeder Einstellung zurück
Ausgabestill(path, frame), render_range(dir, f0, f1)

stop ist die Blendenzahl, als ob die Figur ein 40 cm Sammlerstück wäre: 2-2,8 für Einstellungen, 4 für Gesichter, 5,6-8 für Masters. Kleiner = unschärfer.

Passform mit den anderen Fähigkeiten des Benutzers

  • Script: scriptmaxxing für jeden indonesischen Voice-Over. Halte es kurz; die Referenz mit 13,7 Mio. Aufrufen hat keine.
  • Musik und Effekte: ~/Ngonten/Maxxing/audio-lib (CC0). Führe beatgrid.py auf dem Track aus, bevor du die Einstellungen planst.
  • Der eigene Avatar des Benutzers: K.Avatar() lädt ihn mit seinem Gesichts-Rig (Blinzeln, Brauen, wortgenaue indonesische Lippenbewegung von Roblox/blender/face/face_rig.py). K.Char.talk() ist limitierte Animation nur für andere Sprecher. Probiere es aus: build.py -- --avatar --stills.
  • Requisiten und Sets: robloxmaxxing/blender/rbx_kit.py baut im gleichen Stud-Maßstab; Poly Haven (MCP für Blender search_assets, oder das 3d-assets MCP) für CC0-PBR-Texturen und reale Requisiten; Meshy für eine Helden-Requisite. Realistische Requisiten sind der Punkt.
  • Vertikale Reels: --aspect 9:16. Alles hier gilt; Masters gehen auf 24-28 mm und die Tiefe wird entlang der Linsenachse gestapelt.

Hart erkämpfte Regeln für die Nahaufnahme (Negara Angin, 2026-11-21)

  • Messen, dann einrahmen. Gib die ausgewerteten Positionen von Kopf, Händen und Requisite in den Bildern der Einstellung aus, dann platziere die Kamera mit Cam.distance_for. Mit bloßem Auge platzierte Makro-Kameras endeten 0,5 Studs von Objekten entfernt, die 2 brauchten.
  • Roblox-Hände sind große Blöcke. Ein Telefon, das „in" ihnen gehalten wird, ist vergraben; halte Requisiten vor den Händen entlang der Bildschirm-Normalen.
  • Bone-parentere keine Requisite und setze dann ihre Welt-Matrix (sie landet am Ursprung). Halte die Requisite welt-fest, während die Pose hält, oder parente mit dem Operator.
  • Stills ignorieren die Schnittmarker. Ein an eine Kamera gebundener Marker überschreibt scene.camera auf diesem Bild: lösche sie für Stills.
  • Der Haken ist ein Bild und ein Ereignis. Bild 1 muss bereits schön sein (Negara Angin: ein Regentropfen, der im extremen Makro das Fenster hinunterläuft, die Lichter des Raums darin gebrochen), und der erste Takt muss es verändern (der Kick zieht den Fokus durch den Tropfen).
  • Übergänge werden entworfen, nicht hinzugefügt: Durchstoße einen Bildschirm in die Welt, die er zeigt (rendere das erste Bild der nächsten Einstellung als das Bildschirmbild), peitsche aus einer Einstellung heraus und in die nächste hinein.

Verwandte Skills