Communitygithub.com

gertie

Escribe un pequeño archivo de escena y lo compila en Lottie JSON verificado y SVG animado, además de GIF, video y películas multi-escena con subtítulos y música. Para iconos, loaders, logotipos animados, stickers y bucles cortos. Renderiza en un navegador, compara fotogramas uno a uno y no entrega una escena que no pase el control de calidad.

¿Qué es gertie?

Gertie es una herramienta avanzada para creadores de animaciones que convierte un pequeño archivo de escena escrito por el usuario en animaciones terminadas en formato Lottie JSON y SVG animado. Está diseñada para desarrolladores, diseñadores de UI/UX y creadores de contenido que necesitan animaciones ligeras, verificables y de alta calidad para iconos, loaders, logotipos animados, stickers y bucles cortos. Gertie soporta múltiples plataformas (Telegram, Discord, Slack, WhatsApp) y formatos de exportación como GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 y archivos .lottie. Su flujo de trabajo incluye la escritura de una escena en JSON, compilación, validación automática, renderizado en navegador (para comparar Lottie y SVG fotograma a fotograma), y controles de calidad rigurosos que detectan errores como saltos en bucles, recortes o diferencias de paridad entre formatos. Además, permite crear videos multi-escena con subtítulos, transiciones y música, así como animaciones de caracteres ASCII. Gertie se ejecuta en Node.js y requiere un navegador para las verificaciones de renderizado completas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace gertie?

Gertie convierte un pequeño archivo de escena que escribes en una animación terminada, como Lottie JSON y como SVG animado. Tú decides qué dibujar y cómo se mueve. Gertie compila, verifica y renderiza.

Esta versión cubre escritura, compilación, validación y control de calidad de escenas, con ambas salidas, y exportación a GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 y un archivo .lottie, o directamente a una plataforma con sus límites (Telegram, Discord, Slack, WhatsApp y más), y construcción de videos multi-escena con subtítulos, transiciones y música desde un storyboard, y creación de animaciones de caracteres de texto (ASCII). Lee references/export.md antes de exportar, references/video.md antes de hacer un video y references/ascii.md antes de hacer animación ASCII.

Reglas

  1. Nunca escribas Lottie JSON a mano. Escribe un archivo de escena y compílalo.
  2. Nunca presentes un resultado que no haya pasado qa con cero errores.
  3. Lee references/scene.md antes de escribir tu primera escena. Los modelos que lo omiten inventan campos que no existen.
  4. Si el usuario proporciona un SVG, impórtalo en lugar de redibujarlo: lee references/import.md.
  5. Si el usuario proporciona un archivo Lottie, lee references/lottie.md. No lo reescribas a mano.
  6. Si el usuario proporciona un logotipo PNG o JPEG, icono o ilustración plana, calcarlo: lee references/trace.md. Si es una pintura o foto con textura y el usuario quiere que se mueva un poco (un parpadeo, una inclinación de cabeza, un fondo flotante), lee references/cutout.md.
  7. Si el usuario muestra un video o GIF y quiere "algo que se mueva así", lee references/motion-reference.md.
  8. Si el usuario quiere un video de varias escenas (una introducción, un reel, un explicativo, un anuncio) con subtítulos, transiciones o música, lee references/video.md. Escribe una escena por archivo, luego un .story.json, y ejecuta story.
  9. Si el usuario quiere animación ASCII o de caracteres de texto (un banner para README, un loader de terminal, un aspecto retro, un clip denso y colorido de caracteres o puntos), o muestra un clip ASCII para imitar, lee references/ascii.md. Es un motor separado con su propio archivo de escena (.ascii.json) y comandos. Asuntos pequeños: escribe fotogramas en un archivo de texto o genera. Algo denso o suave: construye una escena vectorial, pasa qa y convierte como receta. Varias cosas en movimiento: capas. Para imitar un clip: ascii probe para su cuadrícula y colores. Nunca dibujes formas grandes en caracteres.
  10. Antes de dibujar algo más que unas pocas formas (un personaje, una ilustración, una escena), lee references/artwork.md: orden de construcción, curvas, sombreado, paleta, tamaño del lienzo. Las escenas hechas solo de primitivas o color plano generan W-ART-PRIMITIVE y W-ART-FLAT.
  11. Lee references/motion.md antes de escribir fotogramas clave para algo más que un giro o deslizamiento simple, y siempre para un personaje. Usa preajustes de movimiento y preajustes de rig en lugar de fotogramas clave colocados a mano: le dan a la animación su suavidad, anticipación, sobreimpulso y compresión.

Flujo de trabajo

  1. Entiende la solicitud. Acuerda el tema, el movimiento, el tamaño y si es un bucle. Pregunta solo si una respuesta faltante cambiaría el resultado. Si no, usa valores predeterminados: lienzo 512 por 512, 30 fps, 2 segundos, bucle, fondo transparente.

  2. Escribe la escena como <nombre>.gertie.json. Si el usuario proporcionó un SVG, ejecuta primero node scripts/gertie.mjs import <file.svg> --json e incluye el resultado (ver references/import.md). Los tiempos están en segundos. Los nodos posteriores se dibujan encima de los anteriores. Asigna un preajuste motion donde corresponda. Para un personaje, construye un rig y usa preajustes de rig (references/motion.md).

  3. Verifica. Ejecuta el script en scripts/gertie.mjs dentro de la carpeta de esta habilidad:

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

    Esto compila la escena, valida la salida, renderiza fotogramas de muestra en un navegador y ejecuta las comprobaciones de renderizado. Los archivos van a out/ junto a la escena: <nombre>.lottie.json, <nombre>.svg y <nombre>.sheet.png. La comprobación renderiza el Lottie y el SVG por separado y los compara, fotograma por fotograma.

  4. Corrige cada diagnóstico. Cada uno tiene un code, un path a tu escena, un message y un fix. Aplica la corrección, edita la escena y ejecuta qa de nuevo. Corrige primero los errores, luego lee las advertencias. W-LOOP-JUMP y W-R-LOOP significan que el bucle salta visiblemente; W-R-CLIPPED significa que algo está cortado por el borde del lienzo. W-SYNC significa que tres o más hijos de un grupo ejecutan el mismo bucle al unísono, lo que se ve mecánico: dale al grupo un stagger con un phase, o dale a cada entrada su propio phase. E-R-PARITY significa que el Lottie y el SVG se ven diferentes, por lo que una de las dos salidas es incorrecta: nombra el fotograma, un nodo y una imagen de diferencia (outputs.parity). Simplifica la animación de ese nodo para encontrar la causa e informa al usuario si es un error en Gertie.

  5. Míralo. Abre la imagen de la hoja de contactos nombrada en outputs.sheet. Muestra ocho fotogramas en orden, cada uno etiquetado con su número de fotograma y tiempo, dibujado sobre un tablero de ajedrez para que la transparencia sea visible. Verifica que las cosas correctas estén presentes, los colores sean correctos, el movimiento entre fotogramas tenga sentido y nada esté cortado o superpuesto. Si no está bien, edita la escena y vuelve al paso 3. Detente después de tres rondas de revisión visual. Usa --sheet-frames 16 para más detalle al depurar el tiempo.

  6. Mide contra el nivel de calidad para algo más que un icono rápido. Establece el "tier" de nivel superior de la escena a lo que estás haciendo, luego ejecuta node scripts/gertie.mjs profile <scene>. Ver "Niveles de calidad" más abajo.

  7. Exporta solo si el usuario necesita otro formato: node scripts/gertie.mjs export <scene> --to <formats> o --for <destination>. Ver references/export.md. Necesita ffmpeg para todo excepto lottie, svg y lottie-zip.

  8. Entrega los archivos .lottie.json y .svg, el archivo de escena y la hoja de contactos. Di qué se verificó. Si el informe tiene una lista baked, el SVG lleva un fotograma clave por fotograma para esas propiedades; es correcto pero más grande, y simplificarlos (misma suavización y tiempos en inicio, fin y desplazamiento de recorte; sin suavización de sobreimpulso en una morph o en tamaño de rect y elipse) lo reduce.

Otros comandos:

node scripts/gertie.mjs qa <scene> --thorough     renderiza cada fotograma y también verifica destellos de un fotograma
node scripts/gertie.mjs compile <scene> --json    solo compila, sin navegador; --lottie o --svg escribe solo una salida
node scripts/gertie.mjs validate <file> --json    verifica una escena o cualquier archivo Lottie
node scripts/gertie.mjs export <scene> --to webm --json   escribe otros formatos; ver references/export.md
node scripts/gertie.mjs import <file.svg> --json   convierte un SVG en un fragmento con un resumen y una vista previa etiquetada; ver references/import.md
node scripts/gertie.mjs trace <logo.png> --json      calcografiar un PNG o JPEG plano a formas; luego agrupar; ver references/trace.md
node scripts/gertie.mjs cutout <painting.png> <parts.json> --json   cortar una pintura en capas a lo largo de contornos; ver references/cutout.md
node scripts/gertie.mjs grid <image.png> --step 50   dibujar una cuadrícula etiquetada en una imagen para leer coordenadas de píxeles
node scripts/gertie.mjs render <file.lottie.json> --times 0.6,1.1 --out frames   dibujar fotogramas a tamaño completo en momentos elegidos
node scripts/gertie.mjs story <video.story.json> --json   construir un MP4 a partir de escenas con subtítulos, transiciones y música; ver references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ...   animación de caracteres de texto; ver references/ascii.md
node scripts/gertie.mjs ascii probe <clip.mp4> --json   leer la cuadrícula, colores y velocidad de fotogramas de un clip ASCII para imitar
node scripts/gertie.mjs study <clip.mp4> --json      medir el movimiento en un video o GIF y dibujar una hoja de contactos; ver references/motion-reference.md
node scripts/gertie.mjs study <clip.mp4> --crop x,y,w,h --rate source --json   lo mismo sobre un sujeto a la propia velocidad de fotogramas del clip, con una lista de inactividad para pequeños movimientos
node scripts/gertie.mjs sample <image-or-clip> --at x,y --at x,y   imprimir el color en cada punto como hexadecimal, de los píxeles; --time seconds selecciona el fotograma de un clip
node scripts/gertie.mjs profile <scene or file.json> [--tier icon|character|scene] --json   medir caminos, colores, fotogramas clave y suavización contra las bandas de calidad
node scripts/gertie.mjs inspect <file.json> --json   describir un archivo Lottie; también recolorear, reajustar tiempo y renderizar, ver references/lottie.md
node scripts/gertie.mjs doctor                    informar si Node, un navegador y ffmpeg están disponibles y qué formatos de exportación funcionan

El código de salida 0 significa sin errores, 1 significa que se encontraron errores, 2 significa que el comando no pudo ejecutarse.

Niveles de calidad

Las animaciones hechas profesionalmente del mismo tipo se ven igual al medirlas. profile mide tu animación compilada de la misma manera y marca cada medida inside, below o above de la banda para su nivel. Nunca falla; te dice dónde está la brecha. validate --json y qa --json incluyen el mismo informe bajo profile.

NivelQué esQué necesita más
iconUn icono o loader, de unos 512 píxeles, 1.5 a 3 segundosPocas formas (5 a 20 caminos, 2 a 5 colores), pero cada movimiento suavizado, con sobreimpulso y un bucle limpio
characterUn personaje o ilustración, de 800 a 1024 píxeles, 2 a 6 segundosUn dibujo real: 40 a 80 caminos, 6 a 12 colores y movimiento denso (25 a 60 fotogramas clave por segundo, 4 o más suavizaciones diferentes)
sceneUna escena completa, 1080 píxeles, 5 a 10 segundosMucho más dibujo (120 a 250 caminos, 12 a 20 colores) pero no más movimiento que un personaje: anima bien unas pocas cosas

Declara el nivel en la escena con "tier": "icon" (o "character", "scene") para que el informe marque una banda; sin él profile informa los tres. En cada nivel, apunta a al menos tres cuartos de segmentos suavizados y al menos un cuarto de propiedades animadas comenzando en un fotograma propio (desplazamiento, no sincronizar). Un below en caminos o colores significa que el dibujo es demasiado simple; un below en fotogramas clave por segundo significa que las cosas dejan de moverse entre poses.

Qué puede y no puede hacer cada salida

  • Lottie JSON se reproduce en lottie-web, reproductores dotlottie y reproductores móviles nativos. Úsalo para aplicaciones.
  • GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 se crean con export. Son imágenes de la animación, no vectores.
  • SVG animado no necesita reproductor ni JavaScript. Se reproduce al abrirse en un navegador, en una etiqueta <img> y en un README (verificado en Chromium y WebKit; Firefox no ha sido verificado). No se puede pausar ni desplazar, y las aplicaciones móviles nativas no pueden reproducirlo. Bajo prefers-reduced-motion muestra un solo fotograma fijo, elegido por el poster opcional de nivel superior de la escena (segundos). Las morphs y los cambios de tamaño de rect o elipse siguen moviéndose bajo movimiento reducido.

Si no puedes ver imágenes

Omite el paso 5. Confía en las comprobaciones automáticas e informa al usuario que el resultado fue verificado automáticamente pero no visualmente.

Si no hay navegador

qa aún compila y valida, e informa "render": "skipped" con el comando que lo soluciona. Ejecuta node scripts/gertie.mjs doctor, sigue lo que dice e informa al usuario que las comprobaciones de renderizado no se ejecutaron hasta que lo hagan.

Si no puedes ejecutar comandos

Escribe el archivo de escena siguiendo references/scene.md y entrégalo al usuario con el comando de compilación.

Skills relacionados