Communitygithub.com

VisualxIntelligence/motion-tools-and-skills

Crea vídeos animados tipo caricatura pintados a mano con acuarela y tinta (MP4) usando código — p5.js + p5.brush renderizados cuadro por cuadro en Chrome sin interfaz gráfica y codificados con ffmpeg — protagonizados por Clawd o cualquier personaje.

¿Qué es motion-tools-and-skills?

Esta skill permite generar animaciones cortas completas en código, basadas en el enfoque PDoomVideo / ClaudeAnimationBase. El flujo de trabajo comienza con un storyboard, seguido de la implementación escena por escena usando funciones puras del tiempo `t` en p5.js + p5.brush. El renderizado se realiza en Chrome headless, ya sea como hojas de contacto para revisión o cuadro por cuadro en paralelo, y finalmente ffmpeg codifica el video MP4 (con audio opcional). Las reglas clave incluyen: solo usar pinceles artesanales (paint/inkLine), sin texto, con transiciones en cada costura, y manteniendo el personaje vivo mediante ocios, deriva de cámara y hervido de líneas. La skill está diseñada para plataformas como Claude Code, Cursor o Codex, y es ideal para videos musicales, videos de letras, GIFs animados o cualquier solicitud de 'hacer un video de Clawd'.

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

Preguntar en tu IA favorita

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

Documentación

Animación pintada

Un método para crear cortometrajes animados enteramente en código, destilado de JohnHeibel/PDoomVideo (un video musical de 156 s pintado por Claude Opus) y su kit generalizado ClaudeAnimationBase (MIT), que se incluye aquí como template/.

Cómo funciona: cada cuadro es una función pura del tiempo t. studio.html carga p5.js + p5.brush y tus archivos de escena; cada toma pinta el cuadro completo de 1920×1080 con rellenos de acuarela y líneas de tinta hirviente. render.mjs impulsa Chrome sin interfaz gráfica para renderizar hojas de contacto para revisión, o cada cuadro en paralelo, y ffmpeg codifica el MP4 (con audio si se proporciona).

Flujo de trabajo

0. Andamio

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <directorio-proyecto>        # añadir --keep-demo para mantener la escena de ejemplo conectada

Esto copia la plantilla, desconecta la escena de demostración, ejecuta npm install y verifica node / ffmpeg / Chrome. Luego lee <directorio-proyecto>/ANIMATION_GUIDE.md completamente antes de diseñar cualquier cosa: contiene las reglas, los principios de animación y la API completa del motor / Clawd. Mira docs/emotions.jpg y docs/views.jpg (las hojas de modelo) con la herramienta Read.

Para un video musical o cualquier cosa más larga de ~20 s, lee también references/music-video.md. Para un video de letras, primero pide el archivo de canción y un LRC, y mide el tempo con scripts/beat_grid.py: las líneas suelen ser más rápidas de lo que crees.

1. Storyboard antes del código

Escribe STORYBOARD.md en el proyecto (formato en la guía: logline, arco de mundo + paleta, motivo, arco emocional del personaje, luego tomas con lecturas — la lista temporizada de lo que el espectador debe entender). Ejemplo práctico: examples/xiaozhen/ (un video de letras de 31 s: storyboard y código completo de escena).

Muestra el storyboard al usuario y deja que reaccione antes de construir, a menos que haya dicho que sigas adelante.

2. Construir toma por toma

  • Establece duration, bpm, offset (y audio) en src/config.js.
  • Un archivo por escena/capítulo envuelto en IIFE en src/scenes/, terminando con shots([[t0, fn], ...]); añade su <script> a studio.html.
  • Bloquea primero las poses clave, verifícalas como imágenes fijas, luego añade el movimiento entre ellas.

3. Renderizar y revisar — cada toma, varias veces

No puedes ver el movimiento leyendo código. Desde el directorio del proyecto:

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # fotogramas clave
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # cada cuadro de un momento
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # detalle a resolución completa

Abre cada imagen con Read y compárala con la lista de revisión de la guía: ¿evento claro? ¿personaje suficientemente grande? ¿lecturas temporizadas para que un espectador novato las entienda? ¿anticipación / seguimiento, sin cortes? ¿pies y accesorios sostenidos tocando? ¿transiciones en cada costura? ¿sin texto, sin 3D, sin blanco/negro puro, sin brillos embarrados? Corrige y revisa de nuevo. Presupuesto: ≥ 1 hoja por toma, una tira por movimiento clave y transición, un recorte por rostro que lleve la historia.

4. Renderizar el video

node render.mjs --clip --out=out/video.mp4                                   # videos cortos, un trabajador
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # largos, paralelo + reanudable

Reporta la ruta de salida, duración y ms/cuadro. Ofrece open out/video.mp4.

Las reglas más importantes

Estas son las reglas de la guía condensadas; la guía es la autoridad.

  1. Medio artesanal. Solo paint() / inkLine() (p5.brush) — nunca rect/ellipse/fill simples de p5. Solo 2D plano: los giros pasan por vistas clave dibujadas (turn(), spinView()), nunca proyección 3D. Luz mediante glow() (aditiva), porque mezclar pigmentos hace que amarillo sobre azul se vuelva verde.
  2. Sin texto. Sin subtítulos, etiquetas, letreros ni bocadillos; muéstralo en su lugar. Las reacciones son emotes pintados (!, sudor, corazones…). La única excepción es el karaoke en un video de letras, y como máximo unos pocos efectos de sonido grandes.
  3. Algo sucede en cada toma — un evento, causa → reacción, preparaciones que se resuelven.
  4. Tiempo para el espectador. Enumera las lecturas de cada toma; una lectura a la vez; acciones rápidas, significados sostenidos; guía el ojo; las lecturas establecen la duración de la toma. Aquí es donde falla la animación generada.
  5. Vivo. Nada está quieto (ocios de feel(), cámara a la deriva, hervido); los rostros cambian mediante emotions() nunca intercambiando; el personaje es grande (plano medio u≈20–28, primer plano 40–70); todo sigue el ritmo.
  6. Transiciones en cada costura, elegidas para ajustarse a la historia (barrido de pincel, iris / iris con forma, paneo rápido, corte por correspondencia, corte en acción, arrastre de cámara).
  7. Una sola pieza. Un mundo, un arco de color, un hilo emocional, escenas vinculadas, un final que rima con el comienzo.

Peculiaridades del motor

  • Funciones puras de t. Los cuadros se renderizan en paralelo y fuera de orden: sin estado entre cuadros, sin Math.random(), sin física cuadro por cuadro. Usa hash(i) para aleatoriedad estable, jit() para hervido.
  • boilSeed(key) antes de cada elemento/fondo/prop separado, o una cosa en movimiento hará que todo lo dibujado después de ella vuelva a hervir cada cuadro (temblor).
  • No nombres globales como los de p5. p5 define line, OVERLAY, text, color, scale, … como globales; una function line() de nivel superior falla con Cannot redefine property y la página nunca se vuelve lista (el renderizador se agota). Mantén las ayudas dentro de la IIFE de la escena o dales nombres distintos.
  • Capas en puertas, ventanas y pantallas: dibuja lo que está dentro, luego pinta la pared/marco circundante sobre ello, de modo que nada más ancho que la abertura se muestre fuera (el inDoor del tren + jambas de puerta, las piezas del bisel del televisor).
  • Un NaN en una lista de puntos lanza Failed to construct 'OffscreenCanvas' — protege la geometría degenerada.
  • Bajo zoom de cámara ≳ 2, las formas grandes pierden contornos; el grosor del contorno escala con el zoom, así que reduce sw en primeros planos.
  • Costo = número de rellenos y trazos. Apunta a ≤ ~1.5–2.5 s/cuadro (el registro imprime ms/cuadro). Prefiere formas menos y más grandes. En máquinas sin GPU real, los rellenos de acuarela son lentos — considera menos formas de fill, o --soft-gl como último recurso.
  • macOS: el renderizador usa --use-angle=metal y encuentra /Applications/Google Chrome.app automáticamente; de lo contrario, pasa --chrome=<ruta>.

Adaptación

  • Clawd es la estrella predeterminada, no un requisito. Los nuevos personajes, accesorios y emociones se dibujan con las mismas herramientas (paint, ribbon, through, glow) y se mantienen fieles al modelo en todas las tomas; las nuevas emociones van en EMO en src/clawd.js.
  • src/karaoke.js (plantilla) añade karaoke palabra por palabra para videos de letras mediante el gancho window.overlayHook en core.js.
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png crea un bucle sin costuras para GIFs (ffmpeg -i out/loop_name/f%04d.png …).
  • Un mayor esfuerzo de razonamiento tiende a dar escenas más extravagantes y detalladas.

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.

Skills relacionados