Communitygithub.com

Animação Pintada (motion-tools-and-skills)

Crie vídeos animados no estilo cartoon aquarelado e nanquim (MP4) usando código — p5.js + p5.brush renderizado quadro a quadro em Chrome headless e codificado com ffmpeg — estrelado por Clawd ou qualquer personagem.

O que é Animação Pintada (motion-tools-and-skills)?

Esta skill permite que agentes de IA gerem animações curtas completas em código, inspirada no projeto PDoomVideo e ClaudeAnimationBase. Ela funciona transformando cada quadro em uma função pura do tempo `t`, usando `studio.html` para carregar p5.js e p5.brush, onde cada cena pinta o quadro inteiro 1920×1080 com preenchimentos aquarelados e linhas de nanquim em constante ebulição. O script `render.mjs` coordena o Chrome headless para criar folhas de contato para revisão ou renderizar todos os quadros em paralelo, e então o ffmpeg codifica o MP4 final — com suporte a áudio para vídeos musicais. Suporta fluxos de trabalho para storyboard, construção cena por cena, loop de revisão visual (comandos como `--sheet`, `--strip`, `--crop`), e sincronização música/letra. É ideal quando o usuário pede para criar uma animação, curta-metragem, desenho animado, videoclipe, vídeo com letra, GIF/loop animado, ou menciona a abordagem PDoomVideo / ClaudeAnimationBase. Também lida com vídeos longos dividindo o trabalho entre subagentes.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/painted-animation

Perguntar na sua IA favorita

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

Documentação

Animação pintada

Um método para fazer curtas-metragens animados inteiramente em código, destilado de JohnHeibel/PDoomVideo (um videoclipe de 156 s pintado por Claude Opus) e seu kit generalizado ClaudeAnimationBase (MIT), que está incluído aqui como template/.

Como funciona: cada quadro é uma função pura do tempo t. O studio.html carrega p5.js + p5.brush e seus arquivos de cena; cada cena pinta o quadro inteiro 1920×1080 com preenchimentos aquarelados e linhas de nanquim em ebulição. O render.mjs comanda o Chrome headless para renderizar folhas de contato para revisão, ou cada quadro em paralelo, e o ffmpeg codifica o MP4 (com áudio, se fornecido).

Fluxo de trabalho

0. Estruturação inicial

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir>        # use --keep-demo para manter a cena de exemplo conectada

Isso copia o template, desconecta a cena de exemplo, executa npm install e verifica node / ffmpeg / Chrome. Em seguida, leia <project-dir>/ANIMATION_GUIDE.md na íntegra antes de projetar qualquer coisa: ele contém as regras, os princípios de animação e a API completa do motor / Clawd. Veja docs/emotions.jpg e docs/views.jpg (as folhas de modelo) com a ferramenta Read.

Para um videoclipe ou qualquer coisa com mais de ~20 s, leia também references/music-video.md. Para um vídeo com letra, peça o arquivo da música e um LRC primeiro, e meça o andamento com scripts/beat_grid.py: as linhas geralmente são mais rápidas do que você imagina.

1. Storyboard antes do código

Escreva STORYBOARD.md no projeto (formato no guia: logline, arco do mundo + paleta, motivo, arco emocional do personagem, depois cenas com leituras — a lista temporal do que o espectador deve entender). Exemplo prático: examples/xiaozhen/ (um videoclipe com letra de 31 s: storyboard e código completo da cena).

Mostre o storyboard ao usuário e deixe-o reagir antes de construir, a menos que ele tenha dito para ir em frente.

2. Construa cena por cena

  • Defina duration, bpm, offset (e audio) em src/config.js.
  • Um arquivo por cena/capítulo em src/scenes/, envolto em IIFE, terminando com shots([[t0, fn], ...]); adicione seu <script> ao studio.html.
  • Bloqueie as principais poses primeiro, verifique-as como imagens estáticas, depois adicione o movimento entre elas.

3. Renderize e veja — cada cena, várias vezes

Você não pode ver o movimento lendo código. A partir do diretório do projeto:

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # quadros-chave
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # cada quadro de um momento
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # detalhe em resolução total

Abra cada imagem com Read e verifique-a contra a lista de revisão do guia: evento claro? personagem grande o suficiente? leituras temporizadas para que um espectador de primeira viagem as entenda? antecipação / acompanhamento, sem cortes secos? pés e objetos segurados tocando o chão? transições em cada emenda? sem texto, sem 3D, sem preto/branco puro, sem brilhos sujos? Corrija e veja novamente. Orçamento: ≥ 1 folha por cena, uma tira por movimento chave e transição, um recorte por rosto que carrega a história.

4. Renderize o vídeo

node render.mjs --clip --out=out/video.mp4                                   # vídeos curtos, um worker
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # longos, paralelo + retomável

Informe o caminho de saída, duração e ms/quadro. Ofereça open out/video.mp4.

As regras que mais importam

Estas são as regras do guia condensadas; o guia é a autoridade final.

  1. Meio artesanal. Apenas paint() / inkLine() (p5.brush) — nunca rect/ellipse/fill simples do p5. Apenas 2D plano: giros passam por vistas chave desenhadas (turn(), spinView()), nunca projeção 3D. Iluminação via glow() (aditiva), porque misturar pigmentos faz amarelo sobre azul virar verde.
  2. Sem texto. Sem legendas, rótulos, placas ou balões de fala; mostre em vez disso. Reações são emotes pintados (!, suor, corações…). A única exceção é o karaokê em um vídeo com letra, e no máximo alguns grandes SFX.
  3. Algo acontece em cada cena — um evento, causa → reação, preparações que se pagam.
  4. Tempo para o espectador. Liste as leituras de cada cena; uma leitura de cada vez; ações rápidas, significados mantidos; guie o olhar; as leituras definem a duração da cena. É aqui que a animação gerada mais falha.
  5. Vivo. Nada está parado (sons de parado de feel(), câmeras à deriva, ebulição); rostos mudam através de emotions() nunca por troca; o personagem é grande (plano médio u≈20–28, close-up 40–70); tudo segue o ritmo.
  6. Transições em cada emenda, escolhidas para se adequar à história (escovada, íris / íris modelada, panning com chicote, corte combinado, corte em ação, câmera contínua).
  7. Uma peça só. Um mundo, um arco de cores, um fio emocional, cenas ligadas, um final que rima com a abertura.

Peculiaridades do motor

  • Funções puras de t. Os quadros são renderizados em paralelo e fora de ordem: sem estado entre quadros, sem Math.random(), sem física quadro a quadro. Use hash(i) para aleatoriedade estável, jit() para ebulição.
  • boilSeed(key) antes de cada elemento/prop de fundo separado, ou uma coisa em movimento faz com que tudo desenhado depois dela fervilhe novamente a cada quadro (tremulação).
  • Não nomeie globais com o nome de funções do p5. p5 define line, OVERLAY, text, color, scale, … como globais; uma function line() no nível superior falha com Cannot redefine property e a página nunca fica pronta (o renderizador expira). Mantenha auxiliares dentro da IIFE da cena ou dê a eles nomes distintos.
  • Camadas em portas, janelas e telas: desenhe o que está dentro, depois pinte a parede/quadro ao redor novamente sobre ele, para que nada mais largo que a abertura apareça do lado de fora (os batentes da porta do trem, as peças da moldura da TV).
  • Um NaN em uma lista de pontos lança Failed to construct 'OffscreenCanvas' — proteja geometria degenerada.
  • Sob zoom de câmera ≳ 2, formas enormes perdem contornos; o peso do contorno escala com o zoom, então reduza sw em close-ups.
  • Custo = número de preenchimentos e traços. Almeje ≤ ~1.5–2.5 s/quadro (o log imprime ms/quadro). Prefira menos formas, maiores. Em máquinas sem uma GPU real, os preenchimentos aquarelados são lentos — considere menos formas fill, ou --soft-gl como último recurso.
  • macOS: o renderizador usa --use-angle=metal e encontra /Applications/Google Chrome.app automaticamente; caso contrário, passe --chrome=<path>.

Adaptação

  • Clawd é a estrela padrão, não um requisito. Novos personagens, props e emoções são desenhados com as mesmas ferramentas (paint, ribbon, through, glow) e mantidos no modelo entre cenas; novas emoções vão em EMO em src/clawd.js.
  • src/karaoke.js (template) adiciona karaokê palavra por palavra para vídeos com letra via o gancho window.overlayHook em core.js.
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png cria um loop sem emendas para GIFs (ffmpeg -i out/loop_name/f%04d.png …).
  • Um esforço de raciocínio mais alto tende a dar cenas mais extravagantes e detalhadas.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

VisualxIntelligence/motion-tools-and-skills

Make kinetic-typography motion reels (MP4) in code: showreels, portfolio or work reels, product promos, intro films, "motion design"-style videos with bold condensed type, HUD micro-type, black/cream/lime palette, three.js generative layers (particle terrain, liquid marble, chrome knot, particle clouds), shape-continuity transitions and a synthesized, beat-locked score. Canvas 2D + WebGL rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when the user asks for a reel, showreel, motion-graphics / kinetic-type video, a "Work Reel" in this style, or to extend/re-cut the Work Reel ’26.

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

Habilidades Relacionadas