Communitygithub.com

Gertie

Escreve um pequeno arquivo de cena e o compila para Lottie JSON verificado e SVG animado, além de GIF, vídeo e filmes com várias cenas, legendas e música. Para ícones, carregadores, vinhetas de logotipo, adesivos e loops curtos. Renderiza em um navegador, compara quadros lado a lado e não entrega uma cena que falhe no QA.

O que é Gertie?

Gertie é uma skill para agentes de IA (como Claude Code) que transforma um pequeno arquivo de cena descritivo em animações vetoriais completas nos formatos Lottie JSON e SVG animado. Ela cobre todo o fluxo de trabalho: escrita da cena, compilação, validação e verificação de qualidade (QA) com renderização em navegador e comparação quadro a quadro entre os dois formatos. A skill também suporta exportação para múltiplos formatos (GIF, WebM, MP4, etc.), criação de vídeos com várias cenas, legendas e música a partir de um storyboard, e até animação em caracteres ASCII. É especialmente útil para desenvolvedores que precisam de animações leves e verificadas para interfaces, ícones, carregadores ou adesivos, sem depender de ferramentas de design tradicionais. Gertie impõe regras rigorosas: nunca escrever Lottie JSON manualmente, só entregar resultados que passem no QA com zero erros, e sempre ler a documentação de referência antes de escrever a primeira cena ou usar formatos específicos. A skill inclui dezenas de comandos utilitários para inspeção, perfilamento de qualidade (com tiers como icon, character, scene), rastreamento de imagens, estudo de motion reference e diagnóstico do ambiente.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Gertie faz?

Gertie transforma um pequeno arquivo de cena que você escreve em uma animação finalizada, como Lottie JSON e como SVG animado. Você decide o que desenhar e como se move. Gertie compila, verifica e renderiza.

Esta versão cobre escrita, compilação, validação e verificação de qualidade de cenas, com ambas as saídas, e exportação para GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 e um arquivo .lottie, ou diretamente para uma plataforma com seus limites (Telegram, Discord, Slack, WhatsApp e mais), e construção de vídeos com várias cenas, legendas, transições e música a partir de um storyboard, e animação em caracteres de texto (ASCII). Leia references/export.md antes de exportar, references/video.md antes de fazer um vídeo e references/ascii.md antes de fazer animação ASCII.

Regras

  1. Nunca escreva Lottie JSON manualmente. Escreva um arquivo de cena e compile-o.
  2. Nunca apresente um resultado que não tenha passado em qa com zero erros.
  3. Leia references/scene.md antes de escrever sua primeira cena. Modelos que pulam isto inventam campos que não existem.
  4. Se o usuário fornecer um SVG, importe-o em vez de redesenhá-lo: leia references/import.md.
  5. Se o usuário fornecer um arquivo Lottie, leia references/lottie.md. Não o reescreva manualmente.
  6. Se o usuário fornecer um logotipo PNG ou JPEG, ícone ou ilustração plana, trace-o: leia references/trace.md. Se for uma pintura ou foto com textura e o usuário quiser que ela se mova um pouco (uma piscada, uma inclinação de cabeça, um fundo flutuante), leia references/cutout.md.
  7. Se o usuário mostrar um vídeo ou GIF e quiser "algo que se mova assim", leia references/motion-reference.md.
  8. Se o usuário quiser um vídeo de várias cenas (uma introdução, um reel, um explicador, um anúncio) com legendas, transições ou música, leia references/video.md. Escreva uma cena por arquivo, depois um .story.json, e execute story.
  9. Se o usuário quiser animação ASCII ou de caracteres de texto (um banner de README, um carregador de terminal, um visual retrô, um clipe denso e colorido de caracteres ou pontos), ou mostrar um clipe ASCII para imitar, leia references/ascii.md. É um motor separado com seu próprio arquivo de cena (.ascii.json) e comandos. Assuntos pequenos: escreva quadros em um arquivo de texto ou gere-os. Qualquer coisa densa ou suave: construa uma cena vetorial, passe por qa e converta-a como uma receita. Várias coisas se movendo: camadas. Para imitar um clipe: ascii probe para sua grade e cores. Nunca desenhe formas grandes em caracteres.
  10. Antes de desenhar algo além de algumas formas (um personagem, uma ilustração, uma cena), leia references/artwork.md: ordem de construção, caminhos curvos, sombreamento, paleta, tamanho da tela. Cenas feitas apenas de primitivas ou cor sólida levantam W-ART-PRIMITIVE e W-ART-FLAT.
  11. Leia references/motion.md antes de escrever keyframes para algo além de uma rotação ou deslizamento simples, e sempre para um personagem. Use predefinições de movimento e predefinições de rig em vez de keyframes colocados manualmente: elas dão à animação sua suavidade, antecipação, ultrapassagem e compressão.

Fluxo de Trabalho

  1. Entenda a solicitação. Defina o assunto, o movimento, o tamanho e se ele faz loop. Pergunte apenas se uma resposta ausente mudaria o resultado. Caso contrário, use os padrões: tela 512 por 512, 30 fps, 2 segundos, looping, fundo transparente.

  2. Escreva a cena como <nome>.gertie.json. Se o usuário forneceu um SVG, execute node scripts/gertie.mjs import <arquivo.svg> --json primeiro e inclua o resultado (veja references/import.md). Os tempos estão em segundos. Nós posteriores desenham sobre os anteriores. Dê às coisas uma predefinição de motion onde uma se encaixar. Para um personagem, construa um rig e use predefinições de rig (references/motion.md).

  3. Verifique-a. Execute o script em scripts/gertie.mjs dentro da pasta desta skill:

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

    Isto compila a cena, valida a saída, renderiza quadros amostrados em um navegador e executa as verificações de renderização. Os arquivos vão para out/ ao lado da cena: <nome>.lottie.json, <nome>.svg e <nome>.sheet.png. A verificação renderiza o Lottie e o SVG separadamente e os compara, quadro a quadro.

  4. Corrija cada diagnóstico. Cada um tem um code, um path para sua cena, uma message e um fix. Aplique a correção, edite a cena e execute qa novamente. Corrija os erros primeiro, depois leia os avisos. W-LOOP-JUMP e W-R-LOOP significam que o loop salta visivelmente; W-R-CLIPPED significa que algo está cortado pela borda da tela. W-SYNC significa que três ou mais filhos de um grupo executam o mesmo loop em sincronia, o que parece mecânico: dê ao grupo um stagger com um phase, ou dê a cada entrada seu próprio phase. E-R-PARITY significa que o Lottie e o SVG parecem diferentes, então uma das duas saídas está errada: nomeia o quadro, um nó e uma imagem de diferença (outputs.parity). Simplifique a animação desse nó para encontrar a causa e informe ao usuário se for um bug no Gertie.

  5. Observe-a. Abra a imagem da folha de contato nomeada em outputs.sheet. Ela mostra oito quadros em ordem, cada um rotulado com seu número de quadro e tempo, desenhados em um tabuleiro de xadrez para que a transparência seja visível. Verifique se as coisas certas estão presentes, as cores estão corretas, o movimento entre os quadros faz sentido e nada está cortado ou sobreposto. Se não estiver certo, edite a cena e volte ao passo 3. Pare após três rodadas de revisão visual. Use --sheet-frames 16 para mais detalhes ao depurar temporização.

  6. Meça contra o padrão de qualidade para qualquer coisa além de um ícone rápido. Defina o "tier" de nível superior da cena para o que você está fazendo, depois execute node scripts/gertie.mjs profile <cena>. Veja "Níveis de qualidade" abaixo.

  7. Exporte apenas se o usuário precisar de outro formato: node scripts/gertie.mjs export <cena> --to <formatos> ou --for <destino>. Veja references/export.md. Precisa de ffmpeg para tudo exceto lottie, svg e lottie-zip.

  8. Entregue os arquivos .lottie.json e .svg, o arquivo de cena e a folha de contato. Diga o que foi verificado. Se o relatório tiver uma lista baked, o SVG carrega um keyframe por quadro para essas propriedades; está correto, mas maior, e simplificá-las (mesma suavização e tempos em trim start, end e offset; sem suavização de ultrapassagem em um morph ou em tamanho de rect e ellipse) o reduz.

Outros comandos:

node scripts/gertie.mjs qa <cena> --thorough     renderiza todos os quadros e também verifica flashes de um quadro
node scripts/gertie.mjs compile <cena> --json    apenas compila, sem navegador; --lottie ou --svg escreve apenas uma saída
node scripts/gertie.mjs validate <arquivo> --json   verifica uma cena ou qualquer arquivo Lottie
node scripts/gertie.mjs export <cena> --to webm --json   escreve outros formatos; veja references/export.md
node scripts/gertie.mjs import <arquivo.svg> --json   transforma um SVG em um fragmento com um resumo e uma pré-visualização rotulada; veja references/import.md
node scripts/gertie.mjs trace <logo.png> --json      traça um PNG ou JPEG plano para formas; depois agrupa; veja references/trace.md
node scripts/gertie.mjs cutout <pintura.png> <partes.json> --json   corta uma pintura em camadas ao longo de contornos; veja references/cutout.md
node scripts/gertie.mjs grid <imagem.png> --step 50   desenha uma grade rotulada em uma imagem para ler coordenadas de pixels
node scripts/gertie.mjs render <arquivo.lottie.json> --times 0.6,1.1 --out quadros  renderiza quadros em tamanho real em tempos escolhidos
node scripts/gertie.mjs story <video.story.json> --json   constrói um MP4 a partir de cenas com legendas, transições e música; veja references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ...   animação em caracteres de texto; veja references/ascii.md
node scripts/gertie.mjs ascii probe <clipe.mp4> --json   lê a grade, cores e taxa de quadros de um clipe ASCII para imitar
node scripts/gertie.mjs study <clipe.mp4> --json      mede o movimento em um vídeo ou GIF e desenha uma folha de contato; veja references/motion-reference.md
node scripts/gertie.mjs study <clipe.mp4> --crop x,y,w,h --rate source --json   o mesmo em um assunto na própria taxa de quadros do clipe, com uma lista de inatividade para pequenas oscilações
node scripts/gertie.mjs sample <imagem-ou-clipe> --at x,y --at x,y   imprime a cor em cada ponto como hex, a partir dos pixels; --time segundos escolhe o quadro de um clipe
node scripts/gertie.mjs profile <cena ou arquivo.json> [--tier icon|character|scene] --json   mede caminhos, cores, keyframes e suavização contra as faixas de qualidade
node scripts/gertie.mjs inspect <arquivo.json> --json   descreve um arquivo Lottie; também recolorir, reajustar tempo e renderizar, veja references/lottie.md
node scripts/gertie.mjs doctor                    relata se Node, um navegador e ffmpeg estão disponíveis e quais formatos de exportação funcionam

Código de saída 0 significa sem erros, 1 significa que erros foram encontrados, 2 significa que o comando não pôde ser executado.

Níveis de qualidade

Animações feitas profissionalmente do mesmo tipo parecem semelhantes quando medidas. profile mede sua animação compilada da mesma forma e marca cada medida como inside, below ou above a faixa para seu nível. Nunca falha; diz onde está a lacuna. validate --json e qa --json incluem o mesmo relatório sob profile.

NívelO que éO que mais precisa
iconUm ícone ou carregador, cerca de 512 pixels, 1.5 a 3 segundosPoucas formas (5 a 20 caminhos, 2 a 5 cores), mas cada movimento suavizado, com ultrapassagem e um loop limpo
characterUm personagem ou ilustração, 800 a 1024 pixels, 2 a 6 segundosUm desenho real: 40 a 80 caminhos, 6 a 12 cores e movimento denso (25 a 60 keyframes por segundo, 4 ou mais suavizações diferentes)
sceneUma cena completa, 1080 pixels, 5 a 10 segundosMuito mais desenho (120 a 250 caminhos, 12 a 20 cores), mas não mais movimento que um personagem: anime algumas coisas bem

Declare o nível na cena com "tier": "icon" (ou "character", "scene") para que o relatório marque uma faixa; sem ele, profile relata todas as três. Em todos os níveis, busque pelo menos três quartos dos segmentos suavizados e pelo menos um quarto das propriedades animadas começando em um quadro próprio (offset, não sincronize). Um below em caminhos ou cores significa que o desenho é muito simples; um below em keyframes por segundo significa que as coisas param de se mover entre as poses.

O que cada saída pode e não pode fazer

  • Lottie JSON toca em lottie-web, players dotlottie e players móveis nativos. Use-o para aplicativos.
  • GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 são feitos por export. São imagens da animação, não vetores.
  • SVG animado não precisa de player nem JavaScript. Toca quando aberto em um navegador, em uma tag <img> e em um README (verificado no Chromium e WebKit; Firefox não foi verificado). Não pode ser pausado ou arrastado, e aplicativos móveis nativos não podem tocá-lo. Sob prefers-reduced-motion mostra um quadro estático, escolhido pelo poster opcional de nível superior da cena (segundos). Morphs e alterações de tamanho de rect ou ellipse continuam se movendo sob movimento reduzido.

Se você não pode ver imagens

Pule o passo 5. Confie nas verificações automáticas e diga ao usuário que o resultado foi verificado automaticamente, mas não foi visualizado.

Se não houver navegador

qa ainda compila e valida, e relata "render": "skipped" com o comando que o corrige. Execute node scripts/gertie.mjs doctor, siga o que ele diz e informe ao usuário que as verificações de renderização não foram executadas até que o façam.

Se você não pode executar comandos

Escreva o arquivo de cena seguindo references/scene.md e entregue-o ao usuário com o comando de compilação.

Habilidades Relacionadas