Communitygithub.com

Gertie

Écrit un fichier de scène et le compile en Lottie JSON vérifié et SVG animé, ainsi qu'en GIF, vidéo et films multi-scènes avec légendes et musique. Pour icônes, chargements, habillages logo, autocollants et boucles courtes. Il effectue le rendu dans un navigateur, compare les images une par une, et ne livre pas une scène qui échoue au QA.

Qu'est-ce que Gertie ?

Gertie est un outil spécialisé pour les agents IA, conçu pour transformer une description textuelle de scène en une animation vectorielle prête à l'emploi, au format Lottie JSON et SVG animé. Il cible les développeurs et créateurs de contenu qui ont besoin de petites animations optimisées comme des icônes, des chargeurs, des animations de logo, des autocollants ou des boucles courtes pour le web, les applications mobiles ou les plateformes de messagerie (Telegram, Discord, Slack, WhatsApp). L'outil fonctionne en deux étapes : l'utilisateur (ou l'agent) rédige un fichier de scène au format `.gertie.json`, puis Gertie le compile, le valide et effectue un rendu dans un navigateur pour comparer image par image les sorties Lottie et SVG, garantissant une parité parfaite. Il génère également des formats d'export comme GIF, WebM, MP4, et peut construire des vidéos multi-scènes avec légendes, transitions et musique à partir d'un storyboard. Gertie intègre un système de contrôle qualité strict : les scènes doivent passer la commande `qa` sans erreur pour être livrées. Il détecte automatiquement les problèmes de boucle, de clipping, de synchronisation mécanique et de différence entre les rendus Lottie et SVG. Pour les animations avancées (personnages, scènes complètes), il propose des paliers de qualité (icône, personnage, scène) avec des métriques de profilage. Son architecture repose sur un script Node.js (`scripts/gertie.mjs`) et nécessite un navigateur et ffmpeg pour les rendus et exports.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajithonmain/gertie/tree/HEAD/skills/gertie

Demander à votre IA préférée

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

Documentation

Que fait Gertie ?

Gertie transforme un petit fichier de scène que vous écrivez en une animation terminée, au format Lottie JSON et SVG animé. Vous décidez quoi dessiner et comment cela bouge. Gertie compile, vérifie et effectue le rendu.

Cette version couvre l'écriture, la compilation, la validation et le contrôle qualité des scènes, avec les deux sorties, et l'export vers GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 et une archive .lottie, ou directement vers une plateforme avec ses limites (Telegram, Discord, Slack, WhatsApp et plus), ainsi que la construction de vidéos multi-scènes avec légendes, transitions et musique à partir d'un storyboard, et la création d'animations en caractères (ASCII). Lisez references/export.md avant d'exporter, references/video.md avant de créer une vidéo et references/ascii.md avant de faire une animation ASCII.

Règles

  1. N'écrivez jamais de Lottie JSON à la main. Écrivez un fichier de scène et compilez-le.
  2. Ne présentez jamais un résultat qui n'a pas passé qa avec zéro erreur.
  3. Lisez references/scene.md avant d'écrire votre première scène. Les modèles qui l'ignorent inventent des champs qui n'existent pas.
  4. Si l'utilisateur fournit un SVG, importez-le au lieu de le redessiner : lisez references/import.md.
  5. Si l'utilisateur fournit un fichier Lottie, lisez references/lottie.md. Ne le réécrivez pas à la main.
  6. Si l'utilisateur fournit un logo PNG ou JPEG, une icône ou une illustration plate, tracez-le : lisez references/trace.md. S'il s'agit d'une peinture ou d'une photo avec texture et que l'utilisateur souhaite qu'elle bouge un peu (un clin d'œil, une inclinaison de tête, un arrière-plan flottant), lisez references/cutout.md.
  7. Si l'utilisateur montre une vidéo ou un GIF et veut "quelque chose qui bouge comme ça", lisez references/motion-reference.md.
  8. Si l'utilisateur veut une vidéo de plusieurs scènes (une intro, un reel, un explicatif, une pub) avec légendes, transitions ou musique, lisez references/video.md. Écrivez une scène par fichier, puis un .story.json, et exécutez story.
  9. Si l'utilisateur veut une animation ASCII ou en caractères (une bannière README, un chargeur de terminal, un look rétro, un clip dense et coloré de caractères ou de points), ou montre un clip ASCII à imiter, lisez references/ascii.md. Il s'agit d'un moteur séparé avec son propre fichier de scène (.ascii.json) et ses propres commandes. Petits sujets : écrivez les frames dans un fichier texte ou générez-les. Tout ce qui est dense ou fluide : construisez une scène vectorielle, passez qa, et convertissez-la en recette. Plusieurs choses en mouvement : des couches. Pour imiter un clip : ascii probe pour sa grille et ses couleurs. Ne dessinez jamais de grandes formes en caractères.
  10. Avant de dessiner quoi que ce soit au-delà de quelques formes (un personnage, une illustration, une scène), lisez references/artwork.md : ordre de construction, courbes, ombrage, palette, taille du canevas. Les scènes composées uniquement de primitives ou de couleurs unies lèvent W-ART-PRIMITIVE et W-ART-FLAT.
  11. Lisez references/motion.md avant d'écrire des images clés pour quoi que ce soit au-delà d'une simple rotation ou glissade, et toujours pour un personnage. Utilisez des préréglages de mouvement et de rig plutôt que des images clés placées manuellement : ils donnent à l'animation son assouplissement, son anticipation, son dépassement et son écrasement.

Workflow

  1. Comprendre la demande. Déterminez le sujet, le mouvement, la taille et si cela boucle. Ne demandez que si une réponse manquante changerait le résultat. Sinon, utilisez les valeurs par défaut : canevas 512 par 512, 30 ips, 2 secondes, bouclage, fond transparent.

  2. Écrire la scène sous la forme <nom>.gertie.json. Si l'utilisateur a fourni un SVG, exécutez d'abord node scripts/gertie.mjs import <fichier.svg> --json et incluez le résultat (voir references/import.md). Les temps sont en secondes. Les nœuds ultérieurs se dessinent par-dessus les précédents. Donnez aux choses un préréglage motion là où il convient. Pour un personnage, construisez un rig et utilisez des préréglages de rig (references/motion.md).

  3. Vérifier. Exécutez le script scripts/gertie.mjs dans le dossier de cette compétence :

    node scripts/gertie.mjs qa <nom>.gertie.json --json
    

    Cela compile la scène, valide la sortie, effectue le rendu d'images échantillonnées dans un navigateur et exécute les contrôles de rendu. Les fichiers vont dans out/ à côté de la scène : <nom>.lottie.json, <nom>.svg et <nom>.sheet.png. La vérification effectue le rendu du Lottie et du SVG séparément et les compare, image par image.

  4. Corriger chaque diagnostic. Chacun a un code, un path dans votre scène, un message et un fix. Appliquez le correctif, modifiez la scène et relancez qa. Corrigez d'abord les erreurs, puis lisez les avertissements. W-LOOP-JUMP et W-R-LOOP signifient que la boucle saute visiblement ; W-R-CLIPPED signifie que quelque chose est coupé par le bord du canevas. W-SYNC signifie que trois enfants ou plus d'un même groupe exécutent la même boucle à l'unisson, ce qui semble mécanique : donnez au groupe un stagger avec un phase, ou donnez à chaque entrée son propre phase. E-R-PARITY signifie que le Lottie et le SVG ont un rendu différent, donc l'une des deux sorties est erronée : elle nomme l'image, un nœud et une image de différence (outputs.parity). Simplifiez l'animation de ce nœud pour trouver la cause, et informez l'utilisateur s'il s'agit d'un bug dans Gertie.

  5. Regarder. Ouvrez l'image de la planche contact nommée dans outputs.sheet. Elle montre huit images dans l'ordre, chacune étiquetée avec son numéro d'image et son temps, dessinée sur un damier pour que la transparence soit visible. Vérifiez que les bonnes choses sont présentes, que les couleurs sont correctes, que le mouvement entre les images a du sens et que rien n'est coupé ou ne se chevauche. Si ce n'est pas correct, modifiez la scène et revenez à l'étape 3. Arrêtez après trois cycles de révision visuelle. Utilisez --sheet-frames 16 pour plus de détails lors du débogage du timing.

  6. Mesurer par rapport au niveau de qualité pour tout ce qui dépasse une icône rapide. Définissez le "tier" de premier niveau de la scène sur ce que vous fabriquez, puis exécutez node scripts/gertie.mjs profile <scène>. Voir "Niveaux de qualité" ci-dessous.

  7. Exporter uniquement si l'utilisateur a besoin d'un autre format : node scripts/gertie.mjs export <scène> --to <formats> ou --for <destination>. Voir references/export.md. Il nécessite ffmpeg pour tout sauf lottie, svg et lottie-zip.

  8. Livrer les fichiers .lottie.json et .svg, le fichier de scène et la planche contact. Dites ce qui a été vérifié. Si le rapport a une liste baked, le SVG porte une image clé par image pour ces propriétés ; c'est correct mais plus volumineux, et les simplifier (même assouplissement et mêmes temps sur le début, la fin et le décalage de coupe ; pas d'assouplissement de dépassement sur une morphose ou sur la taille d'un rectangle et d'une ellipse) le réduit.

Autres commandes :

node scripts/gertie.mjs qa <scène> --thorough     effectue le rendu de chaque image et vérifie également les flashs d'une seule image
node scripts/gertie.mjs compile <scène> --json    compilation seule, sans navigateur ; --lottie ou --svg écrit une seule sortie
node scripts/gertie.mjs validate <fichier> --json    vérifie une scène ou tout fichier Lottie
node scripts/gertie.mjs export <scène> --to webm --json   écrit d'autres formats ; voir references/export.md
node scripts/gertie.mjs import <fichier.svg> --json   transforme un SVG en un fragment avec un résumé et un aperçu étiqueté ; voir references/import.md
node scripts/gertie.mjs trace <logo.png> --json      trace un PNG ou JPEG plat en formes ; puis groupe ; voir references/trace.md
node scripts/gertie.mjs cutout <peinture.png> <parts.json> --json   découpe une peinture en couches le long des contours ; voir references/cutout.md
node scripts/gertie.mjs grid <image.png> --step 50   dessine une grille étiquetée sur une image pour lire les coordonnées des pixels
node scripts/gertie.mjs render <fichier.lottie.json> --times 0.6,1.1 --out frames   effectue le rendu d'images pleine taille à des temps choisis
node scripts/gertie.mjs story <vidéo.story.json> --json   construit un MP4 à partir de scènes avec légendes, transitions et musique ; voir references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ...   animation en caractères ; voir references/ascii.md
node scripts/gertie.mjs ascii probe <clip.mp4> --json   lit la grille, les couleurs et la fréquence d'images d'un clip ASCII à imiter
node scripts/gertie.mjs study <clip.mp4> --json      mesure le mouvement dans une vidéo ou un GIF et dessine une planche contact ; voir references/motion-reference.md
node scripts/gertie.mjs study <clip.mp4> --crop x,y,w,h --rate source --json   la même chose sur un seul sujet à la fréquence d'images du clip, avec une liste d'arrêt pour les petites oscillations
node scripts/gertie.mjs sample <image-ou-clip> --at x,y --at x,y   affiche la couleur à chaque point en hexadécimal, à partir des pixels ; --time secondes sélectionne l'image d'un clip
node scripts/gertie.mjs profile <scène ou fichier.json> [--tier icon|character|scene] --json   mesure les chemins, les couleurs, les images clés et l'assouplissement par rapport aux bandes de qualité
node scripts/gertie.mjs inspect <fichier.json> --json   décrit un fichier Lottie ; également recolorer, re-temporiser et effectuer le rendu, voir references/lottie.md
node scripts/gertie.mjs doctor                    signale si Node, un navigateur et ffmpeg sont disponibles, et quels formats d'export fonctionnent

Le code de sortie 0 signifie aucune erreur, 1 signifie que des erreurs ont été trouvées, 2 signifie que la commande n'a pas pu s'exécuter.

Niveaux de qualité

Les animations fabriquées professionnellement du même type se ressemblent une fois mesurées. profile mesure votre animation compilée de la même manière et marque chaque mesure inside, below ou above la bande pour son niveau. Il n'échoue jamais ; il vous indique où se trouve l'écart. validate --json et qa --json incluent le même rapport sous profile.

NiveauCe que c'estCe dont il a le plus besoin
iconUne icône ou un chargeur, environ 512 pixels, 1,5 à 3 secondesPeu de formes (5 à 20 chemins, 2 à 5 couleurs), mais chaque mouvement assoupli, avec dépassement et une boucle propre
characterUn personnage ou une illustration, 800 à 1024 pixels, 2 à 6 secondesUn vrai dessin : 40 à 80 chemins, 6 à 12 couleurs, et un mouvement dense (25 à 60 images clés par seconde, 4 assouplissements différents ou plus)
sceneUne scène complète, 1080 pixels, 5 à 10 secondesBeaucoup plus de dessin (120 à 250 chemins, 12 à 20 couleurs) mais pas plus de mouvement qu'un personnage : animez bien quelques choses

Déclarez le niveau dans la scène avec "tier": "icon" (ou "character", "scene") pour que le rapport marque une bande ; sans cela, profile signale les trois. Dans chaque niveau, visez au moins les trois quarts des segments assouplis et au moins un quart des propriétés animées commençant sur leur propre image (décalage, ne pas synchroniser). Un below sur les chemins ou les couleurs signifie que le dessin est trop simple ; un below sur les images clés par seconde signifie que les choses arrêtent de bouger entre les poses.

Ce que chaque sortie peut et ne peut pas faire

  • Lottie JSON se lit dans lottie-web, les lecteurs dotlottie et les lecteurs mobiles natifs. Utilisez-le pour les applications.
  • GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 sont fabriqués par export. Ce sont des images de l'animation, pas des vecteurs.
  • SVG animé ne nécessite ni lecteur ni JavaScript. Il se lit lorsqu'il est ouvert dans un navigateur, dans une balise <img> et dans un README (vérifié dans Chromium et WebKit ; Firefox n'a pas été vérifié). Il ne peut pas être mis en pause ou parcouru, et les applications mobiles natives ne peuvent pas le lire. Sous prefers-reduced-motion, il affiche une seule image fixe, choisie par le poster facultatif de premier niveau de la scène (en secondes). Les morphoses et les changements de taille de rect ou d'ellipse continuent de bouger en mouvement réduit.

Si vous ne pouvez pas voir les images

Sautez l'étape 5. Fiez-vous aux contrôles automatiques et dites à l'utilisateur que le résultat a été vérifié automatiquement mais pas regardé.

S'il n'y a pas de navigateur

qa compile et valide toujours, et signale "render": "skipped" avec la commande qui le corrige. Exécutez node scripts/gertie.mjs doctor, suivez ce qu'il dit, et dites à l'utilisateur que les contrôles de rendu n'ont pas été exécutés jusqu'à ce qu'ils le soient.

Si vous ne pouvez pas exécuter de commandes

Écrivez le fichier de scène en suivant references/scene.md et donnez-le à l'utilisateur avec la commande de compilation.

Skills associés