CommunityImagegithub.com

vector-avator

Transformez une illustration unique de personnage en un avatar vectoriel 2D animé pour ce dépôt (vector-avator) : restylez-le et créez deux feuilles de personnage avec Codex imagegen, demandez à Fable 5.2 de dessiner des pièces SVG uniquement remplies avec les zones cachées complétées, vérifiez-les et testez les gestes, rotations de tête, clignements et synchronisation labiale dans le visualiseur. Utilisez lorsque l'utilisateur souhaite ajouter un nouveau personnage, refaire les pièces d'un personnage ou demander comment l'exemple a été créé.

Qu'est-ce que vector-avator ?

Le skill vector-avator est un guide complet, étape par étape, pour convertir une seule illustration de personnage (un « art une pièce ») en un avatar vectoriel 2D entièrement animé, prêt pour des gestes, des rotations de tête, des clignements et une synchronisation labiale. Il est conçu pour être utilisé avec des agents d'IA comme Claude Code, conjointement avec Codex CLI (imagegen) et Fable 5.2 (un modèle de dessin vectoriel), et s'exécute dans un dépôt structuré (vector-avator). Le processus comprend plusieurs étapes : rédiger des notes de personnage (caractéristiques à conserver), générer une pose avant redessinée, créer éventuellement des vues d'angle (via MiniMax H3), produire deux feuilles de personnage (vues à 360° et expressions faciales) avec Codex imagegen, confier le découpage en pièces SVG à Fable 5.2 (en peignant uniquement les formes remplies avec les zones cachées), puis vérifier rigoureusement la structure des pièces et la qualité visuelle avant de tester l'animation interactive et d'exporter des vidéos synchronisées labialement. L'ensemble du flux est automatisé via un pipeline Python et Node.js, les développeurs n'intervenant que pour les revues visuelles et les ajustements. Le skill est particulièrement utile pour ajouter de nouveaux personnages, en refaire les pièces, ou comprendre comment le personnage exemple (usagi) a été réalisé. Il met l'accent sur des sorties de haute qualité, le respect des consignes artistiques et une utilisation minimale des ressources (les pièces vectorielles sont dessinées, non extraites de pixels, et les parties cachées sont complétées).

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

D'une illustration unique à un personnage vectoriel animé

Cette procédure permet d'ajouter un nouveau personnage à ce dépôt (vector-avator). À partir d'une illustration unique du personnage, créez une pose avant redessinée dans le même style artistique et une feuille de personnage, demandez à Fable 5.2 de dessiner les pièces en vecteurs, inspectez-les, puis animez-les dans le visualiseur.

Le personnage exemple est un lapin (ID de personnage usagi ; illustration originale dans inputs/kariusagi/). Les résultats complets de chaque étape se trouvent dans public/characters/usagi/vector/ et tools/vector/sheets/characters/usagi.* – comparez-les en cas de doute.

0. Prérequis

Le répertoire de travail est la racine de ce dépôt. Toutes les commandes ci-dessous sont des chemins relatifs par rapport à la racine.

OutilUtilisationÉtapeVérification
Claude Code + Fable 5.2Obligatoire5. Découpage des pièces (sous-agent)Le sous-agent doit pouvoir utiliser Fable 5.2 comme modèle
Codex CLI (imagegen)Obligatoire2. Transformation du style, 4. Feuillescodex --version, codex login effectué (fonctionne avec un abonnement ChatGPT, pas de clé API nécessaire)
Node 22, npmObligatoire7. Visualiseur, 8. Vidéonpm install effectué
Python 3.10+Obligatoire2 à 6python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
resvgObligatoire6. Images de vérificationresvg --version (via cargo install resvg ou autre)
Chromium de Playwright, ffmpegObligatoire7-8. Capture, vidéonpx playwright install chromium, ffmpeg -version
MiniMax H3 (ComfyUI)Optionnel3. Échantillons d'angleAPI ComfyUI (par défaut http://127.0.0.1:8188). Sinon, sautez l'étape 3
TTSOptionnel8. Audio pour synchronisation labialeSinon, utilisez la synchro labiale textuelle pour l'animation

Si Fable 5.2 ou Codex imagegen ne sont pas disponibles, informez-en l'utilisateur et arrêtez-vous. Remplacer le découpage des pièces par un autre modèle conduit à une qualité insuffisante.

Port du serveur de développement : Par défaut 5280 (npm run dev). Si occupé, lancez npx vite --port <port> --strictPort et ajoutez VIEWER_URL=http://127.0.0.1:<port>/ à toutes les commandes de capture et d'export vidéo (viewer_shots.mjs, record.mjs). Indiquez également cette URL dans les instructions transmises à Fable.

Estimation des coûts et du temps (mesurée)

Mesures réelles pour le lapin exemple (47 pièces). Pour les personnages suivants (à partir du second), temps total 1 à 1,5 heure par personnage (y compris l'attente). Le travail humain se limite à la rédaction des caractéristiques et aux revues.

ÉtapeResponsableDuréeNombre de passages
1. Notes du personnageClaude (principal)environ 10 min—
2. Pose avantCodex imagegenenviron 4,7 min2 générations, 1 retenue
3. Échantillons d'angle (optionnel)MiniMax H3environ 7 min1 passage
4. 2 feuillesCodex imagegenenviron 5 min1 chacune
5. Découpage des piècesFable 5.2environ 16 min + environ 2,5 min de corrections1 passage + 1 correction
6-7. Inspection, vérification, ajustementsClaude (principal)environ 20 min—
  • Codex imagegen prend environ 2 à 2,5 minutes par image. Atteindre la limite de votre abonnement ChatGPT peut entraîner plusieurs heures d'attente. Par personnage, il faut 1 à 2 images de face et 2 feuilles.
  • Le découpage par Fable 5.2 a pris environ 22 min (49 pièces) et 24 min (61 pièces) pour deux autres personnages.
  • Un agent ignorant le contexte a réalisé un personnage complet (63 pièces) en utilisant uniquement ce skill : environ 43 min (4 imagegen, 1 passage Fable : environ 24 min, 280k tokens), sans aucune correction.
  • Les compteurs de tokens et les coûts n'ont pas été mesurés.

Vue d'ensemble du processus

ÉtapeContenuOutilSortie
1Rédiger les notes du personnage (caractéristiques à conserver)Manuscrittools/vector/sheets/characters/<id>.md / .json
2Transformer l'illustration originale dans le style commun, créer la pose avant en Amake.py gen <id> restyleref/front.png
3Extraire les images d'une vidéo de rotation à 360° (optionnel)turntable.sh <id>ref/turntable.mp4, ref/angle_*.png
42 feuilles (vues à 360° + formes des mains, variations faciales)make.py gen <id> sheet_turnaround / sheet_faceref/sheet_turnaround.png, ref/sheet_face.png
5Pièces uniquement remplies, complétées jusqu'aux zones cachéesFable 5.2 + references/fable-brief.mdvector.json
6Inspection structurelle et vérification visuelle des imagescheck_parts.py <id>0 erreur
7Tester et ajuster dans le visualiseurnpm run dev, viewer_shots.mjsvector.json ajusté
8Export vidéo et synchronisation labialerecord.mjs, lipsync.pyMP4

ref/ correspond à public/characters/<id>/vector/ref/. L'ID du personnage est en lettres minuscules (ex. usagi). Les images d'essai et les fichiers de travail de Fable sont stockés dans var/vector/<id>/ (non versionnés).

1. Rédiger les notes du personnage

Dans tools/vector/sheets/characters/<id>.md, notez en liste à puces les caractéristiques à conserver même après changement de style. Dans <id>.json, indiquez le chemin de l'illustration originale et son rôle. Placez l'original dans inputs/<id>/ ou similaire.

  • Le format et l'exemple sont dans references/character-notes.md. Exemple pour le lapin : tools/vector/sheets/characters/usagi.md / usagi.json.
  • Notez les couleurs approximatives (#RRGGBB).
  • Le style commun (tools/vector/sheets/style_base.md) dessine le personnage comme un « animal / créature ». Si cela modifie le personnage (ex. poils sur un personnage sans poils, réinterprétation en animal), annulez-le en notant explicitement dans les notes : « ne pas dessiner ~ », « ne pas appliquer ~ ». Ne modifiez pas le fichier de style commun.
  • Si l'original est dans une pose dynamique (torsion, bras pliés), le répertoire layouts/restyle.md demandera le dessin en pose avant en A. Inutile de le mentionner dans les notes ; ajouter dans <id>.json le rôle « ne pas se référer à la pose » stabilise le résultat.

Parallèlement, enregistrez le personnage dans le visualiseur. Nécessaire pour que Fable puisse vérifier à l'étape 5. data/characters/<id>.json :

{ "id": "<id>", "label": "<nom du personnage>", "vector": { "url": "characters/<id>/vector/vector.json" } }

2. Pose avant (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 <numéro>
  • Le prompt assemble « style commun + notes personnage + ce qui est dessiné (layouts/restyle.md) » et le transmet à imagegen via codex exec. Les essais sont stockés dans var/vector/<id>/gen/ avec le prompt et la durée.
  • Inspectez visuellement l'image générée et comparez-la à l'original. Points à vérifier : reconnaît-on le personnage ? Est-il en 2 à 2,5 têtes ? Pose avant en A avec un espace sous les aisselles ? Pas de reflet dans les yeux ? Pas de strabisme ?
  • Si pas conforme, corrigez avec --note "instruction supplémentaire" ou modifiez les notes du personnage (ex. le lapin ressemblait à un autre personnage à cause du « volume des poils » du style commun, annulé dans les notes). Conservez la correction dans les notes.
  • adopt place l'image retenue dans ref/front.png (1024×1536).

3. Échantillons d'angle (optionnel : MiniMax H3)

bash tools/vector/sheets/turntable.sh <id>          # COMFY_SERVER permet de changer l'URL ComfyUI
  • Rédigez d'abord tools/vector/sheets/h3/<id>.txt (prompt de la vidéo de rotation) en utilisant h3/usagi.txt comme modèle. Remplacez uniquement la description du personnage.
  • Les sorties angle_045.png, angle_090.png, angle_180.png sont automatiquement ajoutées comme images de référence pour la génération des feuilles à l'étape 4. La rotation H3 n'étant pas à vitesse constante, les angles sont indicatifs.
  • Si vous n'avez pas ComfyUI ni H3, sautez cette étape. Le découpage des pièces reste possible avec les seules feuilles.

4. Deux feuilles de personnage (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
  • La première feuille comporte 4 vues (face, trois-quarts, profil, dos) et 4 formes de main (ouverte, index pointé, poing, paume) ; la seconde, les variations faciales (yeux : ouverts, mi-clos, fermés ; bouche : fermée, a, i, u, e, o ; expressions : normale, sourire, surprise, gênée).
  • Les vues trois-quarts et profil doivent montrer le visage tourné vers la gauche de l'image (même orientation que la rotation H3).
  • Vérifiez visuellement qu'il s'agit bien du même personnage que la pose avant et que les variations sont cohérentes (ex. les iris ne sont pas écrasés dans les yeux mi-clos). Si non, corrigez avec --note et regénérez.

5. Découpage des pièces (sous-agent Fable 5.2)

  1. À partir du modèle references/fable-brief.md, insérez l'ID du personnage, son nom, les consignes spécifiques et l'URL du visualiseur (par défaut http://127.0.0.1:5280/). Enregistrez le tout dans var/vector/<id>/fable/brief.md. Le format et l'exemple (lapin) pour les consignes spécifiques sont dans references/character-notes.md.
  2. Lancez un sous-agent configuré avec Fable 5.2 et transmettez-lui l'intégralité de brief.md. Fable crée alors public/characters/<id>/vector/vector.json via un script de dessin conforme à references/parts-spec.md, s'inspecte lui-même, puis fait rapport.
  3. Lisez le rapport, puis effectuez l'inspection (étape 6) et la vérification (étape 7). Si des corrections sont nécessaires, demandez-les au même sous-agent (en ouvrir un nouveau perdrait le contexte).

Règles à faire respecter (déjà dans le modèle) :

  • Les pièces sont dessinées à partir de zéro en unités sémantiques. Pas de découpage de pixels ni d'auto-tracé pour déterminer les formes.
  • Dessiner uniquement en remplissage. Les contours sont ajoutés automatiquement au rendu.
  • Compléter les parties cachées (front sous la frange, tête sous la base des oreilles, torse sans les bras, cou, base de la queue, etc.).
  • Ne pas dessiner les bras (générés au rendu). À la place, mesurer et noter les marqueurs du squelette, l'épaisseur et la couleur des bras.
  • _L / _R : la gauche et la droite du personnage lui-même (dans la vue de face, _L est à droite de l'image).

6. Inspection

.venv/bin/python tools/vector/check_parts.py <id>
  • Réussite : 0 erreur. Les avertissements sont à juger.
  • Inspectez visuellement les images de vérification (var/vector/<id>/check/). Les points à vérifier sont dans references/visual-qa.md. Notamment : dans les images avec pièces avant masquées (qa_*.png), vérifiez l'absence de trous ou de coupures ; que les variations (variants.png, expressions.png) correspondent aux feuilles ; et que le squelette (skeleton.png) est cohérent avec le dessin.
  • Les images de vérification n'incluent pas les contours automatiques ni les bras générés. L'apparence finale sera vérifiée à l'étape 7.

7. Tester dans le visualiseur

  1. Assurez-vous que data/characters/<id>.json (créé à l'étape 1) existe.

  2. Lancez le serveur de développement avec npm run dev et ouvrez http://localhost:5280/?char=<id> (si plusieurs personnages, un sélecteur apparaît).

  3. Capturez pour vérifier (serveur de développement en cours) :

    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. Points à vérifier : pas de lignes parasites aux jointures des pièces du personnage (notamment blanc sur blanc), les yeux ne dépassent pas du contour du visage à ±30° de rotation, la base des oreilles/cheveux ne se détache pas de la tête, l'épaisseur et la couleur des bras et des mains sont cohérentes, le mouvement des éléments pendants.

  5. Les ajustements se font en modifiant les valeurs dans vector.json. Testez d'abord avec les paramètres d'URL, puis mettez à jour le fichier. La liste des valeurs ajustables se trouve dans references/tuning.md, les problèmes courants et leurs solutions dans references/troubleshooting.md.

8. Export vidéo et synchronisation labiale

# Vidéo (serveur de développement en cours)
node tools/vector/record.mjs --out out/<id>_explain --motion explain --query "char=<id>"

# Synchronisation labiale : à partir d'un fichier WAV et du texte (en kana pour le japonais). Le type de TTS n'a pas d'importance
.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>"
  • Sans TTS, vous pouvez créer une vidéo avec synchro labiale textuelle : node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --seconds 6 --query "char=<id>&say=こんにちは、よろしくね。". Le texte est répété en boucle selon la durée de la vidéo (déterminée par la durée de la motion, ou par --seconds pour les motions sans boucle). Pour une durée basée sur la longueur du texte, utilisez --seconds (estimation : 0,15 s par more, 0,3 s par ponctuation).
  • Pour un texte en anglais : --lang en. Pour une analyse uniquement basée sur l'amplitude sans texte : --method rms. Si vous disposez de timings de mots issus de Whisper : --whisper whisper.json.
  • Couleur de fond : --query "bg=ffd3e0". Lignes style dessin : vHand=0-4 (aucune, faible, moyenne, forte, dessin à la main +). Fort par défaut.
  • Le visualiseur peut également charger le JSON de synchro labiale et le fichier audio pour lecture.

Une fois terminé

Rapportez à l'utilisateur :

  • Les fichiers créés (images ref/, vector.json, data/characters/<id>.json) et l'emplacement des images de vérification et vidéos
  • Les durées de chaque étape et le nombre de générations/corrections
  • Les résultats de l'inspection et les problèmes restants (pièces dont vous n'êtes pas sûr, rendu non corrigé)

Skills associés