Communitygithub.com

Bewegte Malerei

Erstelle handgemalte Wasserfarben- und Tusche-Zeichentrickvideos (MP4) mit Code – p5.js + p5.brush, Bild für Bild in Headless Chrome gerendert und mit ffmpeg codiert – mit Clawd oder jeder anderen Figur.

Was ist Bewegte Malerei?

Dieses Skill ermöglicht die Erstellung von kurzen, handgezeichneten Zeichentrickvideos vollständig durch Code. Es basiert auf der Methode, bei der jedes Bild eine reine Funktion der Zeit `t` ist. Die `studio.html` lädt p5.js und p5.brush, um jede 1920×1080 Szene mit Aquarellfüllungen und kochenden Tuschelinien zu malen. Das Render-Skript `render.mjs` treibt Headless Chrome an, um Kontaktbögen zur Überprüfung oder jedes Bild parallel zu rendern, und ffmpeg codiert das MP4 (optional mit Audio). Das Skill ist ideal, wenn Nutzer Animationen, Zeichentrickfilme, Musikvideos, Lyrikvideos, animierte GIFs oder Schleifen erstellen möchten. Es führt durch den gesamten Workflow: Storyboard, Szenen-Code, den Render-and-Look-Überprüfungszyklus, die Integration von Musik/Lyrik-Synchronisation und die Aufteilung langer Videos auf Unteragenten. Besondere Regeln stellen sicher, dass nur die Malwerkzeuge (`paint()`/`inkLine()`) verwendet werden, keine Textblasen, jede Einstellung ein Ereignis enthält und ausreichend Zeit für den Betrachter bleibt. Typische Fallstricke wie globale Namenskonflikte mit p5, NaN in Punktlisten oder Performance-Engpässe bei vielen Füllungen werden im Skill detailliert behandelt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/painted-animation

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Bewegte Malerei?

Eine Methode zur Erstellung kurzer Zeichentrickfilme vollständig in Code, destilliert aus JohnHeibel/PDoomVideo (ein 156 s Musikvideo, gemalt von Claude Opus) und seinem verallgemeinerten Kit ClaudeAnimationBase (MIT), das hier als template/ mitgeliefert wird.

So funktioniert es: Jedes Bild ist eine reine Funktion der Zeit t. studio.html lädt p5.js + p5.brush und Ihre Szenendateien; jede Einstellung malt den gesamten 1920×1080 Rahmen mit Aquarellfüllungen und kochenden Tuschelinien. render.mjs treibt Headless Chrome an, um Kontaktbögen zur Überprüfung oder jedes Bild parallel zu rendern, und ffmpeg codiert das MP4 (mit Audio, falls vorhanden).

Arbeitsablauf

0. Grundgerüst

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <projekt-verzeichnis>        # --keep-demo behält die Beispielszene bei

Dies kopiert die Vorlage, entfernt die Demoszene, führt npm install aus und prüft node / ffmpeg / Chrome. Dann lesen Sie <projekt-verzeichnis>/ANIMATION_GUIDE.md vollständig, bevor Sie etwas entwerfen: Es enthält die Regeln, die Animationsprinzipien und die vollständige Engine / Clawd-API. Betrachten Sie docs/emotions.jpg und docs/views.jpg (die Modellblätter) mit dem Read-Werkzeug.

Lesen Sie für ein Musikvideo oder etwas länger als ~20 s auch references/music-video.md. Für ein Lyrikvideo fragen Sie zuerst nach der Songdatei und einem LRC und messen Sie das Tempo mit scripts/beat_grid.py: Zeilen sind normalerweise schneller, als Sie vermuten.

1. Storyboard vor dem Code

Schreiben Sie STORYBOARD.md im Projekt (Format im Leitfaden: Logline, Welt + Palettenbogen, Motiv, der Gefühlsbogen der Figur, dann Einstellungen mit reads – die zeitlich begrenzte Liste dessen, was der Betrachter verstehen muss). Mit Beispiel: examples/xiaozhen/ (ein 31 s Lyrikvideo: Storyboard und vollständiger Szenencode).

Zeigen Sie das Storyboard dem Benutzer und lassen Sie ihn reagieren, bevor Sie bauen, es sei denn, er hat gesagt, machen Sie einfach weiter.

2. Bauen Sie Einstellung für Einstellung

  • Setzen Sie duration, bpm, offset (und audio) in src/config.js.
  • Eine IIFE-umwickelte Datei pro Szene/Kapitel in src/scenes/, endend mit shots([[t0, fn], ...]); fügen Sie ihr <script> zu studio.html hinzu.
  • Blockieren Sie zuerst die wichtigsten Posen, überprüfen Sie sie als Standbilder, dann fügen Sie die Bewegung dazwischen hinzu.

3. Rendern und überprüfen – jede Einstellung, mehrmals

Sie können Bewegung nicht durch Lesen von Code sehen. Vom Projektverzeichnis aus:

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # Schlüsselbilder
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # jedes Bild eines Moments
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # Detail in voller Auflösung

Öffnen Sie jedes Bild mit Read und prüfen Sie es gegen die Checkliste des Leitfadens: Ereignis klar? Figur groß genug? Reads so getimt, dass ein Erstzuschauer sie versteht? Antizipation / Durchziehen, kein Ruckeln? Füße und gehaltene Requisiten berühren? Übergänge an jeder Naht? Kein Text, kein 3D, kein reines Schwarz/Weiß, keine matschigen Glüheffekte? Korrigieren und erneut prüfen. Budget: ≥ 1 Kontaktbogen pro Einstellung, ein Streifen pro Schlüsselbewegung und Übergang, ein Ausschnitt pro geschichtstragendem Gesicht.

4. Video rendern

node render.mjs --clip --out=out/video.mp4                                   # kurze Videos, ein Worker
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # lange, parallel + fortsetzbar

Melden Sie den Ausgabepfad, die Länge und ms/Bild. Bieten Sie open out/video.mp4 an.

Die wichtigsten Regeln

Dies sind die Regeln des Leitfadens zusammengefasst; der Leitfaden ist maßgeblich.

  1. Handgemachtes Medium. Nur paint() / inkLine() (p5.brush) – niemals einfaches p5 rect/ellipse/fill. Nur flache 2D: Drehungen erfolgen über gezeichnete Schlüsselansichten (turn(), spinView()), niemals 3D-Projektion. Licht über glow() (additiv), weil Pigmentmischung Gelb-über-Blau grün macht.
  2. Kein Text. Keine Untertitel, Beschriftungen, Schilder oder Sprechblasen; zeigen Sie es stattdessen. Reaktionen sind gemalte Emoticons (!, Schweißtropfen, Herzen…). Die einzige Ausnahme ist Karaoke in einem Lyrikvideo und höchstens ein paar große SFX.
  3. In jeder Einstellung passiert etwas – ein Ereignis, Ursache → Reaktion, Aufbauten, die sich auszahlen.
  4. Zeit für den Betrachter. Listen Sie die Reads jeder Einstellung auf; ein Read nach dem anderen; schnelle Aktionen, gehaltene Bedeutungen; führen Sie das Auge; die Reads bestimmen die Einstellungslänge. Hier scheitert generierte Animation am meisten.
  5. Lebendig. Nichts ist still (Idles von feel(), driftende Kameras, Kochen); Gesichter ändern sich durch emotions(), niemals durch Austausch; die Figur ist groß (Halbtotal u≈20–28, Nahaufnahme 40–70); alles reitet auf dem Beat.
  6. Übergänge an jeder Naht, gewählt passend zur Geschichte (Pinselwisch, Iris / geformte Iris, Peitschenschwenk, Match Cut, Schnitt auf Aktion, Kameradurchzug).
  7. Ein Stück. Eine Welt, ein Farbbogen, ein emotionaler Faden, verbundene Szenen, ein Ende, das sich mit dem Anfang reimt.

Engine-Fallstricke

  • Reine Funktionen von t. Bilder werden parallel und außer der Reihe gerendert: kein Zustand über Bilder hinweg, kein Math.random(), keine Bild-für-Bild-Physik. hash(i) für stabile Zufälligkeit, jit() für Kochen.
  • boilSeed(key) vor jedem separaten Hintergrundelement/Requisit, sonst kocht ein sich bewegendes Ding alles, was danach gezeichnet wird, jedes Bild neu (Zittern).
  • Benennen Sie keine globalen Variablen nach denen von p5. p5 definiert line, OVERLAY, text, color, scale, … als globale Variablen; eine function line() auf oberster Ebene schlägt fehl mit Cannot redefine property und die Seite wird nie bereit (der Renderer läuft aus). Halten Sie Helfer innerhalb der Szenen-IIFE oder geben Sie ihnen eindeutige Namen.
  • Schichtung bei Türen, Fenstern und Bildschirmen: Zeichnen Sie, was innen ist, dann malen Sie die umgebende Wand/den Rahmen wieder darüber, sodass nichts Breiteres als die Öffnung außerhalb erscheint (der Zug inDoor + Türzargen, die TV-Blendenstücke).
  • Ein NaN in einer Punktliste wirft Failed to construct 'OffscreenCanvas' – schützen Sie entartete Geometrie.
  • Bei Kamera-Zoom ≳ 2 verlieren große Formen ihre Konturen; die Konturlinienstärke skaliert mit Zoom, also reduzieren Sie sw in Nahaufnahmen.
  • Kosten = Anzahl der Füllungen und Striche. Zielen Sie auf ≤ ~1,5–2,5 s/Bild (das Protokoll druckt ms/Bild). Bevorzugen Sie weniger, größere Formen. Auf Maschinen ohne echte GPU sind Aquarellfüllungen langsam – erwägen Sie weniger fill-Formen oder --soft-gl als letzten Ausweg.
  • macOS: Der Renderer verwendet --use-angle=metal und findet /Applications/Google Chrome.app automatisch; geben Sie andernfalls --chrome=<pfad> an.

Anpassen

  • Clawd ist der Standardstar, kein Muss. Neue Figuren, Requisiten und Emotionen werden mit denselben Werkzeugen (paint, ribbon, through, glow) gezeichnet und über Einstellungen hinweg konsistent gehalten; neue Emotionen kommen in EMO in src/clawd.js.
  • src/karaoke.js (Vorlage) fügt Wort-für-Wort-Karaoke für Lyrikvideos über den window.overlayHook-Hook in core.js hinzu.
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png erstellt eine nahtlose Schleife für GIFs (ffmpeg -i out/loop_name/f%04d.png …).
  • Höherer Reasoning-Aufwand führt tendenziell zu extravaganteren, detaillierteren Szenen.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

VisualxIntelligence/motion-tools-and-skills

Make kinetic-typography motion reels (MP4) in code: showreels, portfolio or work reels, product promos, intro films, "motion design"-style videos with bold condensed type, HUD micro-type, black/cream/lime palette, three.js generative layers (particle terrain, liquid marble, chrome knot, particle clouds), shape-continuity transitions and a synthesized, beat-locked score. Canvas 2D + WebGL rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when the user asks for a reel, showreel, motion-graphics / kinetic-type video, a "Work Reel" in this style, or to extend/re-cut the Work Reel ’26.

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

Verwandte Skills