CommunityBildgithub.com

vector-avator

Aus einer einzelnen Charakterillustration einen beweglichen 2D-Vektor-Avatar für dieses Repository (vector-avator) erstellen: Neugestaltung und Erstellung von zwei Charakterblättern mit Codex imagegen, Zeichnen von nur gefüllten SVG-Teilen mit vervollständigten verdeckten Bereichen durch Fable 5.2, Prüfung und Abspielen von Gesten, Kopfdrehungen, Blinzeln und Lippen-Sync im Viewer. Verwenden, wenn der Benutzer einen neuen Charakter hinzufügen, Teile eines Charakters überarbeiten oder erfahren möchte, wie der Beispielcharakter erstellt wurde.

Was ist vector-avator?

Dieses Skill (vector-avator) beschreibt den vollständigen Workflow, um aus einer einzelnen Zeichnung einen animierbaren 2D-Vektor-Avatar zu erstellen. Der Prozess umfasst die Neugestaltung des Charakters in einem einheitlichen Stil mithilfe von Codex imagegen, die Erstellung von zwei Charakterblättern (Vieransichten + Handformen und Gesichtsausdrücke) und die Zerlegung des Charakters in einzelne Füll-SVG-Teile durch Fable 5.2. Dabei werden auch verdeckte Bereiche wie Stirn unter Haaren oder Rumpf unter Armen vervollständigt. Nach einer automatischen Prüfung mit `check_parts.py` wird der Avatar im Viewer getestet und kann Gesten, Kopfdrehungen, Blinzeln und Lippen-Sync ausführen. Das Skill ist für Claude Code mit Fable 5.2 und Codex imagegen optimiert und erfordert zusätzlich Node.js, Python, resvg und optional MiniMax H3 für Beispielansichten. Die gesamte Erstellung eines Charakters dauert etwa 1 bis 1,5 Stunden.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/grmchn/vector-avator/tree/HEAD/.claude/skills/vector-avator

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Aus einer einzelnen Zeichnung einen beweglichen Vektor-Avatar erstellen

Diese Anleitung beschreibt, wie Sie dem Repository (vector-avator) einen neuen Charakter hinzufügen. Ausgehend von einer einzelnen Zeichnung des Charakters wird eine frontale Standfigur im einheitlichen Stil sowie Charakterblätter erstellt, die Teile werden von Fable 5.2 als Vektorgrafiken gezeichnet, geprüft und schließlich im Viewer animiert.

Das Beispiel ist der temporäre Hase (Charakter-ID usagi; Originalzeichnung in inputs/kariusagi/). Die fertigen Dateien der einzelnen Schritte finden Sie in public/characters/usagi/vector/ und tools/vector/sheets/characters/usagi.* – vergleichen Sie bei Unklarheiten.

0. Voraussetzungen

Das Arbeitsverzeichnis ist die Wurzel dieses Repositorys. Alle folgenden Befehle verwenden relative Pfade ausgehend von der Wurzel.

WerkzeugBehandlungVerwendungsschrittÜberprüfung
Claude Code + Fable 5.2Erforderlich5. Aufteilung in Teile (Sub-Agent)Der Sub-Agent muss mit Fable 5.2 als Modell konfiguriert sein
Codex CLI (imagegen)Erforderlich2. Stilkonvertierung, 4. Blättercodex --version, codex login (funktioniert mit ChatGPT-Plan, kein API-Key nötig)
Node 22, npmErforderlich7. Viewer, 8. Videonpm install ausgeführt
Python 3.10+Erforderlich2–6python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
resvgErforderlich6. Überprüfungsbilderresvg --version (z.B. cargo install resvg)
Playwrights Chromium, ffmpegErforderlich7–8. Aufnahme, Videonpx playwright install chromium, ffmpeg -version
MiniMax H3 (ComfyUI)Optional3. WinkelbeispieleComfyUI-API (Standard http://127.0.0.1:8188). Fehlt sie, Schritt 3 überspringen
TTSOptional8. Lippen-Sync-AudioFehlt es, wird der Charakter mit Text-Lippen-Sync animiert

Wenn Fable 5.2 oder Codex imagegen nicht verfügbar sind, informieren Sie den Benutzer und brechen Sie ab. Es hat sich gezeigt, dass die Qualität der Teileaufteilung mit anderen Modellen nicht ausreicht.

Port des Entwicklungsservers: Standard ist 5280 (npm run dev). Wenn dieser Port belegt ist, starten Sie mit npx vite --port <Port> --strictPort und hängen Sie VIEWER_URL=http://127.0.0.1:<Port>/ an alle Befehle für Aufnahme und Videoexport (viewer_shots.mjs, record.mjs). Geben Sie die URL auch in der Anfrage an Fable an.

Kosten- und Zeitrichtwerte (gemessen)

Gemessen bei der Erstellung des temporären Hasen (47 Teile). Für den zweiten und weitere Charaktere beträgt die Bearbeitungszeit inklusive Wartezeit etwa 1–1,5 Stunden pro Charakter. Die manuelle Arbeit beschränkt sich auf das Auflisten der Charaktermerkmale und die Überprüfung.

SchrittZuständigZeitAnzahl
1. CharakterbeschreibungClaude (Haupt-Agent)ca. 10 min—
2. Frontale StandfigurCodex imagegenca. 4,7 min2 Generierungen, 1 angenommen
3. Winkelbeispiele (optional)MiniMax H3ca. 7 min1 Durchlauf
4. Zwei CharakterblätterCodex imagegenca. 5 minJe 1 Durchlauf
5. Aufteilung in TeileFable 5.2ca. 16 min + Korrektur ca. 2,5 min1 + 1 Korrektur
6–7. Prüfung, Bestätigung, AnpassungClaude (Haupt-Agent)ca. 20 min—
  • Codex imagegen benötigt pro Bild etwa 2–2,5 Minuten. Wenn das Nutzungslimit des ChatGPT-Plans erreicht ist, kann es mehrere Stunden dauern. Pro Charakter sind 1–2 frontale Ansichten und 2 Blätter erforderlich.
  • Die Aufteilung durch Fable 5.2 dauerte bei zwei anderen Charakteren ca. 22 Minuten (49 Teile) bzw. ca. 24 Minuten (61 Teile).
  • Als ein Agent ohne Vorkenntnisse mit diesem Skill einen einzelnen Charakter (63 Teile) erstellte, dauerte es insgesamt ca. 43 Minuten (4 imagegen-Durchläufe, 1 Fable-Durchlauf mit ca. 24 Minuten / ca. 280.000 Token, 0 Überarbeitungen), wobei die Winkelbeispiele übersprungen wurden.
  • Tokenanzahl und Kosten wurden nicht gemessen.

Gesamtablauf

SchrittInhaltWerkzeugAusgabe
1Charakterbeschreibung (zu erhaltende Merkmale) schreibenManuelltools/vector/sheets/characters/<id>.md und .json
2Original in gemeinsamen Stil konvertieren, frontale A-Pose erstellenmake.py gen <id> restyleref/front.png
3Einzelbilder aus 360-Grad-Drehvideo extrahieren (optional)turntable.sh <id>ref/turntable.mp4, ref/angle_*.png
4Zwei Blätter (Vieransichten + Handformen, Gesichtsausdrücke)make.py gen <id> sheet_turnaround / sheet_faceref/sheet_turnaround.png, ref/sheet_face.png
5Nur gefüllte Teile zeichnen, verdeckte Bereiche ergänzenFable 5.2 + references/fable-brief.mdvector.json
6Strukturprüfung und Sichtkontrolle der Prüfbildercheck_parts.py <id>0 Fehler
7Im Viewer testen und anpassennpm run dev, viewer_shots.mjsAngepasstes vector.json
8Videoexport und Lippen-Syncrecord.mjs, lipsync.pyMP4

ref/ steht für public/characters/<id>/vector/ref/. Die Charakter-ID verwendet nur Kleinbuchstaben und Ziffern (z.B. usagi). Versuchsbilder und Arbeitsdateien von Fable werden in var/vector/<id>/ gesammelt (nicht versioniert).

1. Charakterbeschreibung schreiben

Schreiben Sie in tools/vector/sheets/characters/<id>.md stichpunktartig die Merkmale, die auch nach der Stiländerung erhalten bleiben sollen. In <id>.json notieren Sie den Pfad zum Originalbild und dessen Rolle. Das Originalbild wird in inputs/<id>/ oder ähnlich abgelegt.

  • Schreibweise und Beispiel finden Sie in references/character-notes.md. Beispiel für den temporären Hasen: tools/vector/sheets/characters/usagi.md und usagi.json.
  • Farben werden als ungefähre Werte (#RRGGBB) angegeben.
  • Der gemeinsame Stil (tools/vector/sheets/style_base.md) zeichnet den Charakter als „Tier/Lebewesen“. Punkte, bei denen der Charakter dadurch ungewollt verändert würde (z.B. Fellbüschel bei einem haarlosen Charakter, oder ein nicht-menschlicher Charakter wird als Tier gezeichnet), werden in der Beschreibung explizit mit „nicht zeichnen“ oder „nicht anwenden“ zurückgesetzt. Die Datei des gemeinsamen Stils wird nicht verändert.
  • Auch wenn das Originalbild eine bewegte Pose (Körperverdrehung, Armbeugung) zeigt, wird die frontale A-Pose durch layouts/restyle.md vorgegeben. Dies muss nicht in der Beschreibung erwähnt werden; ein Hinweis „Pose nicht als Referenz nehmen“ in der roles-Eigenschaft von <id>.json sorgt für Stabilität.

Registrieren Sie den Charakter gleichzeitig im Viewer. Dies wird benötigt, wenn Fable in Schritt 5 den Viewer zur Überprüfung nutzt. data/characters/<id>.json:

{ "id": "<id>", "label": "<Charaktername>", "vector": { "url": "characters/<id>/vector/vector.json" } }

2. Frontale Standfigur (Codex imagegen)

.venv/bin/python tools/vector/sheets/make.py gen <id> restyle --count 2
.venv/bin/python tools/vector/sheets/make.py log <id>
.venv/bin/python tools/vector/sheets/make.py adopt <id> restyle <Nummer>
  • Der Prompt wird aus „gemeinsamer Stil + Charakterbeschreibung + zu zeichnendes Objekt (layouts/restyle.md)“ zusammengesetzt und über codex exec an imagegen übergeben. Versuche bleiben in var/vector/<id>/gen/ zusammen mit Prompt und benötigter Zeit erhalten.
  • Betrachten Sie die generierten Bilder zwingend visuell und vergleichen Sie sie mit dem Original. Achten Sie auf: Ist der Charakter erkennbar? 2–2,5 Kopfgrößen? Echte Frontalansicht in A-Pose mit Zwischenraum unter den Armen? Keine Glanzlichter in den Augen? Nicht schielend?
  • Passt es nicht, korrigieren Sie mit --note "zusätzliche Anweisung" oder überarbeiten Sie die Charakterbeschreibung (Beispiel: Der temporäre Hase sah durch die gemeinsame „Haarfülle“ wie ein anderer Charakter aus, daher wurde dies in der Beschreibung zurückgesetzt). Notieren Sie die Änderung in der Beschreibung.
  • adopt legt das angenommene Bild einheitlich als ref/front.png (1024×1536) ab.

3. Winkelbeispiele (optional: MiniMax H3)

bash tools/vector/sheets/turntable.sh <id>          # COMFY_SERVER zum Ändern der ComfyUI-URL
  • Erstellen Sie zuerst tools/vector/sheets/h3/<id>.txt (Prompt für das Drehvideo) basierend auf der Vorlage h3/usagi.txt. Ersetzen Sie nur den Teil mit der Charakterbeschreibung.
  • Die Ausgaben angle_045.png, angle_090.png, angle_180.png werden automatisch als Referenzbilder für die Blatterstellung in Schritt 4 hinzugefügt. Da die Drehung von H3 nicht gleichmäßig ist, sind die Winkel nur Richtwerte.
  • Wenn ComfyUI und H3 nicht verfügbar sind, überspringen Sie diesen Schritt. Die Aufteilung in Teile ist auch ohne die Winkelbeispiele möglich.

4. Zwei Charakterblätter (Codex imagegen)

.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_turnaround
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_turnaround 1
.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_face
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_face 1
  • Das erste Blatt zeigt eine Vieransicht (Front, Schrägansicht, Seite, Rückansicht) und vier Handformen (offen, Zeigefinger, Faust, Handfläche). Das zweite Blatt zeigt Gesichtsausdrücke (Augen: offen, halb, geschlossen; Mund: zu, a, i, u, e, o; Ausdrücke: neutral, lächelnd, überrascht, traurig/verlegen).
  • Die Schräg- und Seitenansicht zeigen das Gesicht nach links (gleiche Drehrichtung wie H3).
  • Überprüfen Sie visuell, ob der Charakter mit der frontalen Standfigur übereinstimmt und die Ausdrücke konsistent sind (z.B. ist die Iris bei halb geschlossenen Augen nicht gequetscht). Bei Unstimmigkeiten korrigieren Sie mit --note und generieren neu.

5. Aufteilung in Teile (Sub-Agent mit Fable 5.2)

  1. Fügen Sie in die Vorlage references/fable-brief.md die Charakter-ID, den Charakternamen, charakterspezifische Hinweise und die Viewer-URL (Standard http://127.0.0.1:5280/) ein. Speichern Sie das Ergebnis als var/vector/<id>/fable/brief.md. Hinweise und Beispiel (temporärer Hase) finden Sie in references/character-notes.md.
  2. Starten Sie einen Sub-Agenten mit Fable 5.2 und übergeben Sie den vollständigen Inhalt von brief.md. Fable erstellt gemäß references/parts-spec.md mit einem Zeichnungsskript public/characters/<id>/vector/vector.json, prüft es selbstständig und berichtet.
  3. Lesen Sie den Bericht, führen Sie die Prüfung aus Schritt 6 und die Bestätigung aus Schritt 7 durch. Bei Korrekturbedarf beauftragen Sie denselben Sub-Agenten (ein neuer Start würde den Kontext verlieren).

Was eingehalten werden muss (steht in der Vorlage):

  • Teile von Grund auf neu zeichnen – keine Pixelausschnitte oder automatische Konturen zur Formfindung.
  • Nur mit Füllungen zeichnen – Linien werden beim Rendern automatisch hinzugefügt.
  • Auch verdeckte Bereiche ergänzen (Stirn unter Pony, Kopf unter Ohrenansatz, Rumpf bei abgenommenen Armen, Hals, Schwanzansatz usw.).
  • Arme nicht zeichnen (werden beim Rendern generiert). Stattdessen Skelettmarkierungen sowie Armstärke und -farbe messen und notieren.
  • _L und _R beziehen sich auf die Seite des Charakters selbst (in der Frontansicht ist _L rechts im Bild).

6. Prüfung

.venv/bin/python tools/vector/check_parts.py <id>
  • 0 Fehler = bestanden. Warnungen je nach Inhalt bewerten.
  • Betrachten Sie die Prüfbilder (var/vector/<id>/check/) visuell. Prüfpunkte finden Sie in references/visual-qa.md. Achten Sie besonders auf: Löcher oder Schnittkanten bei ausgeblendeten vorderen Teilen (qa_*.png), Übereinstimmung der Variationen (variants.png, expressions.png) mit den Charakterblättern sowie Übereinstimmung der Gelenke im Skelett (skeleton.png) mit der Zeichnung.
  • Die Prüfbilder enthalten keine automatischen Konturen und keine generierten Arme. Das endgültige Erscheinungsbild wird in Schritt 7 überprüft.

7. Im Viewer testen

  1. Stellen Sie sicher, dass data/characters/<id>.json (in Schritt 1 erstellt) vorhanden ist.

  2. Starten Sie den Entwicklungsserver mit npm run dev und öffnen Sie http://localhost:5280/?char=<id> (bei mehr als einem Charakter erscheint eine Auswahl).

  3. Testen Sie durch Aufnahmen (während der Entwicklungsserver läuft):

    DSF=2 node tools/capture/viewer_shots.mjs var/vector/<id>/check/viewer \
      neutral="char=<id>" face30="char=<id>&framing=face&yaw=30&blink=0" faceM30="char=<id>&framing=face&yaw=-30&blink=0" \
      explain="char=<id>&motion=explain&t=1.0" spread="char=<id>&motion=spread&t=1.2" \
      half="char=<id>&framing=face&eye=half&blink=0" point="char=<id>&motion=point&t=1.5"
    
  4. Achten Sie auf: Keine unerwünschten Linien an Teilübergängen bei weißen Charakteren? Treten die Augen bei ±30° Kopfdrehung nicht aus dem Gesichtsumriss? Lösen sich Ohr-/Haaransätze nicht vom Kopf? Stimmen Arm- und Handstärke sowie -farbe? Ist die Bewegung von mitschwingenden Teilen natürlich?

  5. Anpassungen erfolgen über Werte in vector.json. Testen Sie Werte zunächst über URL-Parameter, bevor Sie sie übernehmen. Eine Liste der anpassbaren Werte finden Sie in references/tuning.md, häufige Probleme und Lösungen in references/troubleshooting.md.

8. Videoexport und Lippen-Sync

# Video (während der Entwicklungsserver läuft)
node tools/vector/record.mjs --out out/<id>_explain --motion explain --query "char=<id>"

# Lippen-Sync: aus WAV und Text (Japanisch in Kana). TTS-Typ beliebig
.venv/bin/python tools/lipsync/lipsync.py line.wav --text "こんにちは、よろしくおねがいします。" -o line.json
node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --lipsync line.json --audio line.wav --query "char=<id>"
  • Ohne TTS kann ein Video mit Text-Lippen-Sync erstellt werden: node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --seconds 6 --query "char=<id>&say=こんにちは、よろしくね。". Der Text wird im Takt der Uhr wiederholt. Die Videolänge wird durch die Bewegungslänge (bei nicht-loopenden Bewegungen durch --seconds) bestimmt. Zum Stoppen nach der Textlänge geben Sie --seconds an (Richtwert: 1 Mora 0,15 s, Satzzeichen 0,3 s).
  • Für englischen Text: --lang en, für Lautstärke ohne Text: --method rms, bei Whisper-Wortzeitmarken: --whisper whisper.json.
  • Hintergrundfarbe: --query "bg=ffd3e0"; handgezeichnete Linien: vHand=0–4 (keine, schwach, mittel, stark, handgezeichnet+; Standard stark).
  • Auch im Viewer können Lippen-Sync-JSON und Audiodatei geladen und abgespielt werden.

Nach Abschluss

Melden Sie dem Benutzer:

  • Die erstellten Dateien (ref/-Bilder, vector.json, data/characters/<id>.json) sowie Speicherorte der Prüfbilder und Videos
  • Zeitaufwand und Anzahl der Generierungen/Überarbeitungen pro Schritt
  • Prüfergebnis und verbleibende Probleme (unsichere Teile, nicht vollständig korrigierte Erscheinungsbilder)

Verwandte Skills