Communitygithub.com

craft-2d-animation

Zeigt einem Agenten, wie man eine „2D-Animation“ plant, erstellt oder schneidet, sodass das konkrete Ergebnis eine Bewegung ist, die der Agent Einstellung für Einstellung verteidigen kann. Das Verfahren durchläuft die Schritte der 2D-Animation (EffectCraft + FilmCraft): 1. Visuelle Regie und Lesbarkeit der Szene, 2. Bildausschnitte und visuelle Grammatik. Verwenden Sie dies, wenn eine neue Aufgabe diese Fertigkeit erfordert.

Was ist craft-2d-animation?

Diese Fertigkeit befähigt einen KI-Agenten, vollständige 2D-Animationen – von Intros und Produktdemos bis hin zu kurzen Szenen – in EffectCraft zu konzipieren, zu animieren und zusammenzusetzen, mit optionaler Nachbearbeitung und Export in FilmCraft. Sie deckt die gesamte visuelle Pipeline ab: von farbbasierten Orten und Silhouetten bis hin zu Kamerafahrten, Schnittgrammatik und Animationsprinzipien wie Antizipation und Übertreibung. Die Fertigkeit legt besonderen Wert auf die Lesbarkeit der Szene und schreibt vor, dass jede Szene stumm getestet werden muss, um sicherzustellen, dass die Handlung auch ohne Ton zu 100 % verständlich ist. Sie ist plattformübergreifend für EffectCraft und FilmCraft ausgelegt und nutzt gemeinsame Skripte und Werkzeuge. Die detaillierte Anleitung umfasst die Ankerung von Charakteren und Kameras, die Stapelreihenfolge und ressourcenschonendes Rendern, um auch auf Maschinen mit nur 8 GB RAM zuverlässig zu funktionieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

In Ihrer bevorzugten KI fragen

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

Dokumentation

2D-Animation erstellen (EffectCraft + FilmCraft)

Allgemeine und wiederverwendbare Methode zum Entwerfen, Animieren und Zusammenstellen von Intros, Produktdemos, kurzen Szenen oder 2D-Kurzfilmen in EffectCraft (mit optionalem Schnitt/Export in FilmCraft), mit oder ohne Musikspur.

Referenz für CLI/MCP und gemeinsame Flatpak-Berechtigungen: ../craft-music-video/references/mcp-and-commands.md.


1. Visuelle Regie und Lesbarkeit der Szene

  1. Örtlichkeiten durch Farbe erkennbar: Beschränken Sie eine kurze Szene auf maximal 2 oder 3 Orte, jeder mit einem dominierenden Licht und einer eigenen Palette (z. B. warmer Korridor/Nacht, durch einen Bildschirm beleuchteter Arbeitsplatz, heller Raum mit einer einzigen Akzentfarbe, die Fehlern oder Alarmen vorbehalten ist).
  2. Volle Silhouetten statt dünne Konturen: Bauen Sie Charaktere und Hintergründe aus gefüllten geometrischen Formen (Bézierkurven oder abgerundete Rechtecke) mit minimalistischen Gesichtern (einfache Augen, Augenbrauen, Mund) und einer leichten Gegenlichtkante (rim light) auf der Seite der Lichtquelle.
  3. Silhouettenkontrast: Unterscheiden Sie jeden Charakter bereits in der Miniatur (z. B. abgerundete, geduckte Silhouette vs. aufrechte, breitschultrige Silhouette mit abgehackten Gesten).
  4. Überdimensionierte Hintergründe für Kamerabewegungen: Zeichnen Sie Hintergründe/Wände breiter als das Bild (2200–2400 px für einen Zoom/Shake in 1920×1080 oder 3600+ px für eine panoramische Kamerafahrt), um schwarze Ränder von 10–20 px an den Bildkanten zu vermeiden.

2. Bildausschnitte und visuelle Grammatik

Variieren Sie die Einstellungsgrößen, um die Handlung ohne überflüssigen Text zu erzählen:

EinstellungsgrößeNarrative RolleTechnische Best Practices
Totale (Establishing)Ort, Beleuchtung und relative Position der Elemente vorstellenBehalten Sie bei Rückkehr an denselben Ort einen fixen räumlichen Bezugspunkt bei (Schreibtisch, Bildschirm, Schild, Tür)
Über die Schulter (OTS)Ziel der Figur und ihren Blickwinkel auf eine Oberfläche oder ein Objekt zeigenVerwenden Sie zwischen dem ersten Versuch und dem endgültigen Erfolg exakt denselben OTS-Ausschnitt, um einen sofortigen visuellen Rückbezug zu schaffen
Halbtotale / ProfilHaltung, Bewegungen und physische Entwicklung einer Szene verfolgenIdeal, um allmähliches Zusammensacken, Zurücklehnen auf einem Stuhl oder ausladende Gesten zu zeigen
Großaufnahme (Close-up)Eine Absicht, ein Detail der Oberfläche, eine Hand auf einer Taste, einen Blick oder einen Gag isolierenHalten Sie die Bewegungen kurz und lesbar; nutzen Sie die Großaufnahme, um saubere Negativflächen zu schaffen

Berechnung des Kamerabildausschnitts (cam_focus)

Mit einer Null-Kamera als Anker [0, 0] gehorcht das Zentrieren eines Weltpunkts (tx, ty) in der Mitte eines Bildes W × H bei Maßstab sc % exakt: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (direkt verfügbar über cam_focus(tx, ty, scale_pct, width, height) in ec_runtime.py).


3. Haltungswechsel, Gewicht und visueller Rhythmus

  1. Antizipation → Aktion → Nachgeben / Halten:
    • Gehen Sie niemals linear von Pose A zu Pose B.
    • Fügen Sie vor der Aktion eine kleine, gegenläufige Antizipation ein (z. B. Finger hebt sich und zögert, bevor er eine Taste drückt; Tür öffnet sich leicht, bevor sie zuschlägt; Körper stützt sich ab, bevor er zurückweicht).
    • Beenden Sie mit einem leichten Überschwinger (overshoot) oder einem lesbaren Halt (hold), um Gewicht zu verleihen (z. B. Figur macht einen Schritt zurück und hält inne, um ihre Arbeit zu bewundern).
  2. Allmähliche Haltungsstufen: Lassen Sie die Haltung während einer Warte- oder Spannungsphase in deutlichen Stufen zwischen zwei Einstellungen wechseln (Neigung des Oberkörpers, Senken des Kopfes, Entspannen der Arme), anstatt in einem ständigen Dahinwogen.
  3. Einstellungen zwischen Aktionen halten: Lassen Sie die Komposition zwischen den Akzenten atmen (Augenblinzeln, langsamer Mikro-Zoom, blinkender Cursor), anstatt alle Ebenen ununterbrochen zu bewegen.
  4. Obligatorischer Stummtest: Sehen Sie sich jede Actionszene, jedes Intro oder jede Demo ohne Ton an (oder über 3–5 Schlüsselbilder mit render-frame). Das Ziel der Figur und der Fortschritt der Szene müssen zu 100 % aus dem Bild allein verständlich sein.

4. Anker von Charakteren, Kameras und Stapelreihenfolge (EffectCraft-Fallstricke)

Diese Regeln verhindern Verschiebungsfehler, abgetrennte Gliedmaßen oder versteckte Elemente in EffectCraft (kompatibel mit After Effects):

A. Nullen und Kameras

  • comp.layers.addNull() erstellt standardmäßig einen Anker bei [50, 50] und eine Position bei [960, 540]. Erzwingen Sie IMMER anchorPoint.setValue([0, 0]), bevor Sie die Null positionieren oder parenten (das tut makeCamNull in ec_runtime.py).
  • Weisen Sie IMMER child.parent = parent VOR child.position.setValue(...) zu, damit die Koordinaten von child direkt im lokalen Koordinatensystem des Parents interpretiert werden.

B. Absolute Regel für Parenting und Transformationen

  • Hängen Sie ALLE Kinder an, während das Parent in neutraler Haltung ist (rotation = 0°, scale = [100, 100]).
  • Wenden Sie anfängliche Rotationen, Kamerazooms oder Keyframes des Parents erst NACH vollständiger Erstellung der gesamten Kind-Hierarchie an.
  • Warum: Das Ändern von parent.rotation oder parent.scale vor dem Zuweisen von child.parent = parent löst eine inverse AE-artige Kompensation aus, die den Kopf/die Arme aus dem Körper schleudert oder einen ganzen Hintergrund in einer Ecke des Bildes schrumpft.

C. Ankerhierarchie eines gegliederten 2D-Charakters

  • Sitzender Charakter: Root an der Hüfte (hip_pos) → Chair, Legs, TorsoNull (Drehpunkt Taille [0, 0]) → BackUpperArm (Schulter) → BackForeArm (Ellbogen) → TorsoBody → Head (Halsansatz) → UpperArm → ForeArm.
  • Stehender Charakter: Root am Boden zwischen den Füßen (foot_pos), um die Schuhe bei einem Zoom oder Schritt rückwärts am Boden zu verankern → LegBack / LegFront (Drehpunkt Hüfte) + TorsoPivot (Drehpunkt Hüfte) → Arms, Blazer/Body, Head.
  • Hals-/Kragenanschluss: Fügen Sie immer eine gefüllte Kragen-/Halsform hinzu, die den oberen Teil des Oberkörpers und den unteren Teil des Kopfes überlappt, damit eine starke Neigung (25°–35°) niemals eine Lücke zwischen Kinn und Schultern öffnet.

D. Stapelreihenfolge (Stacking Order)

  • Innerhalb derselben Formebene (ADBE Root Vectors Group): Die erste hinzugefügte Gruppe wird OBEN gezeichnet, die letzte UNTEN (Reihenfolge vorne → hinten).
  • Zwischen verschiedenen Ebenen einer Komposition: Jede neue Ebene wird an Index 1 eingefügt (OBEN). Bauen Sie die Ebenen in der Reihenfolge hinten → vorne auf (Hintergrund → Leuchteffekt → Dekor → Charakter → Vordergrund).

5. Lesbarkeit von Text und Trennung diegetisch / Overlay

  1. Keine permanenten schwarzen Balken: Platzieren Sie Titel, Untertitel oder Legenden im freien Negativraum jeder Einstellung (über einem Bildschirm, in einer dunklen Ecke der Wand, unter einer Horizontlinie), ohne jemals ein Gesicht, eine Bildschirmkante oder ein Schild im Dekor zu überlappen.
  2. Kontrast und Sicherheitsabstände:
    • Wenden Sie einen weichen Schlagschatten an (ADBE Drop Shadow, Deckkraft 190–230, Abstand 4–6 px, Unschärfe 14–18 px), um die Lesbarkeit auf hellem wie dunklem Hintergrund zu gewährleisten.
    • Halten Sie horizontale Sicherheitsabstände (>= 70 px in 1920×1080) und eine lesbare Haltezeit (>= 0.35 s nach Ende der Aktion oder des letzten Wortes, auch durch einen Einstellungsschnitt hinweg) ein.
  3. Strikte Trennung Diegetischer Text (V1) vs. Überlagerter Text (V2):
    • Text im Dekor (V1): Schilder, Bildschirmoberflächen, Blätter, Tafeln, Tastaturtasten. Er ist Teil der animierten Welt und in allen Exporten vorhanden.
    • Überlagerter Text (V2, ProRes 4444 RGBA): Titel, Einblendungen, Untertitel, Text oder UI-Anmerkungen. Platzieren Sie diese in separaten transparenten Kompositionen, um mit einem Klick eine Version mit Titeln und eine saubere Version exportieren zu können, die im Schnitt exakt identisch ist.

6. Visuelle Überprüfung und ressourcenschonendes Rendern

  1. Kontrolle durch Schlüsselbilder vor jedem Video-Render: Verwenden Sie effectcraft-cli render-frame --max-side 960 an 1 bis 2 Schlüsselmomenten pro Einstellung (und --transparent für Overlays V2), um Bildausschnitte, Gelenkanschlüsse und Textlesbarkeit in Sekundenschnelle zu überprüfen.
  2. Sicheres sequenzielles Rendern (8 GB RAM / bescheidene CPU):
    • Rendern Sie immer nur eine Komposition gleichzeitig (niemals parallele ProRes 4444 RGBA-Render auf 8 GB RAM).
    • Begrenzen Sie die Threads (RAYON_NUM_THREADS=2, OMP_NUM_THREADS=2), starten Sie mit niedriger Priorität (nice -n 15 ionice -c 3), vermeiden Sie --gpu, wenn der VRAM mit dem System-RAM geteilt wird, und lassen Sie 2 Sekunden zwischen zwei Rendervorgängen, um Speicher freizugeben.

7. Gemeinsame T3-Code-Werkzeuge und Abhängigkeiten

Die wiederverwendbaren Skripte befinden sich in ~/.t3/shared/craft-video/:

WerkzeugPfadVerwendung in der 2D-Animation
JSX-Runtime für EffectCraft~/.t3/shared/craft-video/ec_runtime.pyImportieren Sie JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script, um sauber eine .ecproj-Datei zu erzeugen (Anker [0,0], Bézier, Glühen, geglättete/Hold-Keyframes)
Sequenzielles Batch-Rendering~/.t3/shared/craft-video/render_ec_batch.shRendern Sie Szenen V* (ProRes HQ RGB) und Overlays L*/T* (ProRes 4444 RGBA) mit geringer Last und automatischer Fortsetzung via ffprobe
Zusammenstellung & Export FilmCraft~/.t3/shared/craft-video/assemble_filmcraft.pyStellen Sie V1 (+ optional V2 Alpha und A1 Audio) in Rec.709 in einer .fcproj-Datei zusammen und exportieren Sie Master + Clean

Benötigte Abhängigkeiten

  • Python 3.9+ (nur Standardbibliothek)
  • ffmpeg und ffprobe
  • EffectCraft CLI (effectcraft-cli oder Flatpak ai.storyteller.effectcraft mit --filesystem-Zugriff)
  • FilmCraft CLI (filmcraft-cli oder Flatpak ai.storyteller.filmcraft) für den Multi-Track-Zusammenschnitt/Export
  • Optional unter Linux: nice, ionice, taskset

Beispielbefehle

# Verfügbare Abhängigkeiten prüfen (kein Rendern)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# Vorschau des sequenziellen Renderplans mit geringer Last (Szene + Alpha-Titel)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# Vorschau des FilmCraft-Zusammenschnitts ohne Musik (stummes Intro/Demo, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

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

Verwandte Skills