Communitygithub.com

code-animation

Erstelle einen 1–2-minütigen Animationskurzfilm zu einem abstrakten Konzept. **Kein generatives Video** – jeder Frame ist ein im Browser berechnetes Vektorbild, das Frame für Frame reproduziert und lokal bearbeitet werden kann.

Was ist code-animation?

Dieses Skill ermöglicht es, abstrakte Konzepte aus Wissenschaft, Mathematik oder Technik in präzise, codegesteuerte Animationsvideos von 1–2 Minuten Dauer umzuwandeln. Anders als generative Videos besteht jeder Frame aus im Browser berechneten Vektorgrafiken, die deterministisch reproduzierbar und lokal modifizierbar sind. Der Workflow ist in drei Schritte gegliedert: Storyboard-Validierung (lint), Build und Rendering zu MP4 sowie automatische Qualitätskontrolle mittels quantifizierbarer Metriken (Bildunterschied, Bewegungsanteil, Abdeckung, Helligkeit). Das Skill stellt acht vordefinierte Shot-Vorlagen zur Verfügung (z. B. Titel, Orbit, Präzession, Aufzug, Warp, Evidenz, Schwarzes Loch) und verwendet eine sechsschichtige Architektur, die professionelle Bildschirmgrafiken erzeugt. Optional kann eine algorithmisch generierte Musikpartitur beigefügt werden, die auf dem Storyboard basiert. Das Skill ist plattformunabhängig und nutzt Python-Skripte für alle Schritte, sodass es in CI/CD-Pipelines, auf lokalen Maschinen oder in serverlosen Umgebungen ausgeführt werden kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shang-en-yee/code-animation-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Code-Animation-Werkstatt (Code Animation)

Erstelle einen 1–2-minütigen Animationskurzfilm zu einem abstrakten Konzept. Kein generatives Video – jeder Frame ist ein im Browser berechnetes Vektorbild, das Frame für Frame reproduziert und lokal bearbeitet werden kann.

Das Ergebnis ist eine MP4-Datei sowie eine wiederverwendbare storyboard.json.


Drei-Schritte-Workflow

# 1. Storyboard validieren
python scripts/lint.py storyboard.json

# 2. Bauen + rendern (ca. 0,5 s/Frame)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4

# 3. Qualitätsprüfung – bei Nichtbestehen wird Exit-Code != 0 zurückgegeben
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json

Wenn die Qualitätsprüfung nicht bestanden wird, nachbessern – nicht mit „sieht gut aus" abnehmen.

Musikuntermalung (optional, aber dringend empfohlen)

Das Audio wird ebenfalls berechnet, nicht aus einer Bibliothek gesampelt – genau wie das Bild.

# 1. Musik synthetisieren (numpy, ca. 40 s)
python scripts/make_audio.py score.wav --storyboard storyboard.json

# 2. In Video muxen, gleichzeitig in H.264 konvertieren und Größe reduzieren
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23

Standardmusik ist für Weltraum-/Physikthemen ausgelegt: D-Moll-Grundton, tiefe lange Töne, pro Szene wechselnder Akkord-Pad, 8-Sekunden-Herzschlagimpuls, spärlich gezupfte Saiten. An Übergängen gibt es Noise-Sweeps, an Kapitelmarken tiefe Bässe.

Bei Themenwechsel die Musikparameter anpassen, nicht einfach übernehmen:

ThemaÄnderung der Musik
Physik / AstronomieStandard beibehalten: Moll, lange Töne, spärlich
Mathematik / AlgorithmenZu Dur oder lydischem Modus wechseln, regelmäßige Arpeggios hinzufügen
Geschichte / GeisteswissenschaftenImpuls entfernen, Pad verlangsamen, einige Dissonanzen hinzufügen
Produkt / TechnikPad-Langtöne entfernen, durch 90–110 BPM Synthesizer-Rhythmus ersetzen

Parameter befinden sich in make_audio.py oben als Konstanten SCALE / ROOT / bpm sowie im build()-Array chords.


storyboard.json

{
  "title": "Schwerkraft",
  "fps": 30,
  "palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
  "scenes": [
    {
      "id": "open",
      "kind": "title",
      "dur": 6.0,
      "cn": "引力",
      "en": "GRAVITY"
    },
    {
      "id": "newton",
      "kind": "orbit",
      "dur": 16.0,
      "chapter": ["I", "苹果与月亮", "THE APPLE AND THE MOON"],
      "subs": [
        [0.6,  "1687 年,牛顿用一个公式,把苹果和月亮绑在了一起。"],
        [7.4,  "引力与质量成正比,与距离的平方成反比。"]
      ]
    }
  ]
}
FeldBeschreibung
kindName der Shot-Vorlage, siehe Tabelle unten
durDauer des Shots (Sekunden), empfohlen 12–20
chapter[Nummer, Titel Deutsch, TITLE ENGLISH], oben links dauerhaft sichtbar
subs[Startsekunde, Text]-Array; jede Anzeige sollte 5–6 Sekunden lang bleiben
cn / enFür Titel-Shots verwendet

Shot-Vorlagen (8 Stück)

kindDarstellungVerwendung
titleGroßer Titel + kleiner englischer UntertitelEröffnung
outroZwei SchlussfolgerungenAbschluss
orbitElliptische Umlaufbahn + PolarkoordinatenrasterPeriodische Bewegungen, Schwerkraft
precessPräzessionsblütenblätter + WinkelscheibeKleine Abweichungen, Präzession
elevatorKasten mit innerer SkalaBezugssysteme, Äquivalenzprinzip
warpPerspektivisches Raumzeitgitter + FührungslinienKrümmung, Felder
evidenceLinsenartige konzentrische Ringe + Chirp-WellenformEvidenz, Signale
blackholeAkkretionsscheibe + Photonenring + ringförmige SkalaExtreme Himmelskörper

Vorlagenparameter befinden sich in templates/shots/*.json.


Sechs-Schichten-Architektur (Warum diese Anordnung)

L5 Postprocessing    Bloom → Vignette → Körnung
L4 Text              Kapitelmarken / großer Text / Formeln / Untertitel
L3 Annotationen      Führungslinien + kleine Labels + Messanzeigen
L2 Hauptinhalt       Kernzeichnung des Shots
L1 Struktur          Gitter / Skalen / Koordinatenachsen
L0 Hintergrund       Nebel / Punktmuster / Staub / entfernte Sterne

L1 und L3 sind die Quelle des „professionellen Looks", nicht L2. Ein Bild nur mit dem Hauptinhalt wirkt schlicht; sobald Struktur- und Annotationsebene hinzugefügt werden, wird dasselbe Bild zu einer „Instrumentenanzeige".

base.html implementiert bereits alle sechs Schichten; neue Shots müssen nur die Zeichenfunktion für L2 schreiben.


Akzeptanzschwellen

reference/thresholds.json:

{
  "frame_diff_min": 1.5,
  "moving_ratio_min": 0.70,
  "coverage_min": 0.20,
  "luma_range": [16, 30]
}
MetrikBedeutungWarum
frame_diffDurchschnittliche Differenz zwischen benachbarten FramesUnter 1,5 ergibt eine „Diashow", keine Animation
moving_ratioAnteil der Frames mit BewegungUnter 70 % wirkt es „stockend"
coverageAnteil der Pixel mit lokaler StrukturUnter 20 % wirkt das Bild leer
lumaDurchschnittliche HelligkeitUnter 16 versinken alle Strukturen im Schwarz; über 30 geht der düstere Grundton verloren

Diese Schwellen wurden mit echten Referenzclips kalibriert – nicht einfach anpassen. Details siehe reference/findings.md.


Bekannte Fallstricke (aus schmerzhafter Erfahrung)

1. Niemals ctx.shadowBlur verwenden. Dutzende von Schatten pro Frame im Software-Rendering erhöhen die Rechenzeit von 20 ms auf 5 Sekunden pro Frame. Stattdessen bloom() aus base.html verwenden – die Leinwand auf 1/6 verkleinern, dann überlagern und vergrößern, zwei drawImage-Aufrufe, nahezu kostenlos.

2. Parameter müssen aus derselben Quelle stammen. Es gab einen Bug, bei dem „Punkte außerhalb der Linie" liefen: Die Linie wurde mit p² berechnet, der Punkt mit p. Pfad und Kopf desselben Objekts müssen von derselben Variable gesteuert werden.

3. Körnung bestimmt die Dateigröße. Frame-für-Frame-Zufallsrauschen hat eine extrem hohe Entropie, die Videocodierer nicht komprimieren können. Bei α=0,03 Körnung sind es etwa 50 KB/Frame bei 1080p30 – das sind ca. 300 MB für ein zwei Minuten langes Video. Für kleinere Dateien α reduzieren (etwa 0,015) oder die Bildrate senken – nicht auf den Codierer hoffen.

4. Frame-Format JPEG verwenden, nicht PNG. Die Codierung von PNG mit Körnung dauert mehr als viermal so lang wie JPEG (gemessen 2,0 s/Frame vs. 0,5 s/Frame).

5. Helligkeit ist kein Filter. Nicht CSS brightness() zum Aufhellen verwenden – das bleicht auch den Text aus. Stattdessen die Alpha-Werte der Inhaltsebenen erhöhen (Gitter, Nebel, Staub), gemäß der Verteilung in reference/palette.json.


Neue Shots erweitern

  1. In drawScene() in base.html einen neuen case hinzufügen
  2. Nur L2 (Hauptinhalt) zeichnen; L1 mit polarGrid / ringTicks / axisTicks / drawInstrument und L3 mit drawLeader verwenden
  3. Anpassbare Parameter als Objekt auslagern und in templates/shots/<name>.json speichern
  4. measure.py ausführen – erst wenn alle drei Metriken bestehen, ist der Shot fertig

Beispiel

examples/gravity.storyboard.json – Vollständiges Storyboard für den Zwei-Minuten-Film „Schwerkraft" mit acht Shots, alle verwendbar. Kann als Ausgangspunkt direkt mit eigenem Text bearbeitet werden.

Verwandte Skills