~/codigoagente
Agentes de IA

Claude Animated Shorts: la skill de Claude Code que crea shorts animados en 3D con three.js y Remotion

Claude Animated Shorts es una skill para Claude Code que produce shorts verticales animados de 55 a 70 segundos: personajes 2D planos con contorno de tinta dentro de un pueblo 3D pintado, cámaras que se deslizan, desenfoque de lente, música de marcha y efectos de sonido. No usa ningún generador de vídeo con IA. Todo se renderiza con three.js dentro de Remotion en tu propio PC, y el sonido se sintetiza con Python.

El repositorio se publicó el 1 de noviembre de 2026 y acompaña al vídeo de YouTube *How to Make Viral Animated Shorts Using Claude*. Lo hemos leído entero (commit e3b817b) para contarte qué trae de verdad, cómo funciona su motor de render, qué necesitas para usarlo y qué partes no conviene copiar tal cual.

Los doce pasos que Claude sigue según `SKILL.md`. En verde, lo que pones tú; en rosa, los controles de calidad · codigoagente

Qué es Claude Animated Shorts

  • Repositorio: github.com/mromidev/claude-animated-shorts
  • Nombre de la skill: cartoon-3d-short (es el name del frontmatter de SKILL.md).
  • Licencia: MIT para el código y la documentación, 2026, "Mr omi". Las imágenes de referencia tienen otra situación, que vemos más abajo.
  • Estado: dos commits, sin *releases* ni package.json. Es el volcado de un proyecto real, no una librería empaquetada.
  • Ejemplo terminado: *The Bridge That Fell for a Song*, un short de 67 s sobre el puente colgante de Broughton (1831), que se vino abajo cuando 74 soldados lo cruzaron marchando al paso.

La idea es que Claude Code tenga en un solo SKILL.md todo lo que el autor aprendió haciendo ese short: el orden de trabajo, la fórmula del guion, los valores finales de color, tinta y cámara, y una lista de errores ya resueltos. Cuando le pides "usa la skill de cartoon short y haz un short sobre…", Claude copia la plantilla del puente y la reescribe para tu historia.

Qué hay dentro del repositorio

CarpetaContenidoTamaño
`SKILL.md`El pipeline completo, las reglas, los valores finales del look y los fallos conocidos15 KB
`templates/bridge/`El código fuente del short del puente: 13 archivos TypeScript (mundo, personajes, tinta, lente, gradación, guion de cámara)~4.800 líneas
`templates/audio/`Síntesis de efectos, música y mezcla en Python con numpy y scipy~2.100 líneas
`templates/scripts/`Stills, hojas comparativas, fusión de sandboxes y QA fotograma a fotograma5 scripts
`references/STYLE_BIBLE.md` y `reports/`La fórmula de guion e imagen medida en 20 shorts de referencia, en siete informes con números~51.000 palabras
`references/frames/` y `sheets/`38 fotogramas y 20 hojas de contactos (1.200 fotogramas) de esos shorts18 MB

Lo más valioso no es el código de una historia concreta, sino los números: cada informe (motion.md, depth.md, outlines.md, grade.md…) traduce un estilo visual a valores medibles, como el grosor de línea en píxeles, la luminancia media por plano o la velocidad máxima de cámara. Eso es lo que un agente puede comprobar; un adjetivo como "más colorido" no.

Cómo funciona el render: three.js dentro de Remotion

Remotion renderiza vídeo a partir de componentes React: cada fotograma es una llamada a tu componente con un número de frame. El paquete @remotion/three mete un lienzo de three.js en ese componente. La plantilla usa esa base para posar un mundo 3D entero en cada fotograma a partir de una línea de tiempo en story.ts.

La cadena de render, reconstruida a partir de los comentarios de `Bridge.tsx`, `ink.ts` y `lensblur.ts` · codigoagente

El mundo y los personajes

  • Mundo 3D (world.ts, build.ts, paint.ts, lights.ts): casas con fachadas, puente, río, cielo con *shader* propio y niebla del color del horizonte. Las texturas se pintan en Canvas2D con las juntas ya oscurecidas. Hay dos presets de luz, día y dorado, con el sol fijo por plano y relativo a la cámara.
  • Props: árboles, farolas, puestos o un molino de los kits CC0 de Kenney, recoloreados por nombre de material. Un "culler" de línea de visión quita cualquier objeto que tape la cámara.
  • Personajes (toon.ts, cast.ts, cardshade.ts): no son modelos 3D. Se dibujan con código en un lienzo de 600×1000 (cabeza en forma de judía, extremidades de un trazo, contorno morado oscuro #241726, 14 expresiones) y se colocan como *billboards* que giran hacia la cámara. Los soldados que marchan al paso comparten lienzos para ahorrar memoria, y la luz de la escena los ilumina como a lo demás.

La tinta, el desenfoque y la gradación

La parte técnicamente más interesante es la cadena de postproceso, en este orden: tinta → lente (dos pases) → bloom → tone mapping NEUTRAL → gradación, con MSAA 4.

  • Tinta (ink.ts): vuelve a renderizar solo el mundo (capa 0) a un buffer de normales y profundidad. Dibuja línea donde hay un salto de profundidad (con la segunda diferencia de 1/z, que da cero exacto en cualquier plano y evita líneas falsas en ángulos rasantes) o un pliegue de más de unos 50°. Los personajes viven en la capa NOINK para que el mundo no les dibuje un rectángulo alrededor.
  • Lente (lensblur.ts): profundidad de campo de lente delgada con un círculo de confusión cInf × |1 − foco/profundidad|. Un pase previo de 16 muestras y otro de 64 en disco de Vogel dan un desenfoque suave sin ruido, así que no parpadea entre fotogramas.
  • Escala: todo valor en píxeles está definido a 1080×1920 y se multiplica por altura / 1920. Por eso un still de prueba a escala 0,5 y el render final a 1440×2560 se ven igual.

El detalle de diseño que más se repite en los comentarios: la tinta es un pase propio antes del desenfoque. Si va en el mismo pase que la profundidad de campo, el desenfoque la sobrescribe; separada, las líneas se desenfocan junto al objeto al que pertenecen.

El sonido sin bancos de audio

templates/audio/ no usa ni un archivo de sonido externo. sfx_gen.py sintetiza con numpy botas sobre tablones, crujidos, cadenas, el chasquido del perno, el chapuzón, pájaros y hasta voces de multitud por formantes. music.py compone una marcha original con instrumentos sintéticos y mix.py mezcla voz, música y efectos con *ducking* bajo la voz, normaliza a −15 LUFS y limita el pico real a −1,2 dBTP. timeline.py replica a mano los tiempos de story.ts, así que cualquier cambio de montaje obliga a volver a generar el sonido.

El método: cómo llegó al look final

La sección más reutilizable de SKILL.md es el bucle de "look-match", útil para cualquier encargo del tipo "haz que se parezca a X":

  1. Medir antes de tocar. Un agente por tema (movimiento, profundidad, texturas, personajes, luz, contornos, gradación) escribe números, no adjetivos, en references/reports/<tema>.md.
  2. Sandboxes con un dueño por archivo. Cinco copias del proyecto (cam, world, mat, char, post), y cada agente solo edita sus archivos.
  3. Fusionar con bridge_merge.py, que hace copia de seguridad, comprobar tipos con npx tsc --noEmit y resincronizar todas las copias.
  4. Verificar con un agente nuevo que puntúa cada área sobre 10 mirando hojas lado a lado y devuelve una lista de arreglos con número de fotograma.

El autor deja las puntuaciones: de 5/3/4/5/4/7/4/6 en la primera ronda a 7 en color de día y personajes tras cuatro rondas. Funciona, pero es caro: varios subagentes en paralelo durante horas.

Cómo instalarla en Claude Code

El README da tres pasos. Esto es lo que implican en la práctica.

1. Copiar la skill

terminalsh
git clone https://github.com/mromidev/claude-animated-shorts ~/.claude/skills/cartoon-3d-short

En Windows, la carpeta es %USERPROFILE%\.claude\skills\cartoon-3d-short. Si es tu primera skill, en esta guía de skills de Claude Code explicamos cómo se cargan.

2. Preparar un proyecto de Remotion

El repositorio no incluye un proyecto de Remotion: no hay package.json, ni src/index.ts, ni Root.tsx, ni la carpeta public/. Tienes que crearlo tú:

terminalsh
npx create-video@latest
npm install @remotion/three three @react-three/fiber @react-three/postprocessing postprocessing

Después copias templates/bridge/ a src/videos/bridge/ y registras la composición BridgeShort (1080×1920, 30 fps, BRIDGE_FRAMES fotogramas) en Root.tsx, como en templates/sandbox_index_example.tsx. Lo comprobamos: con Remotion 4.0.540, three 0.187, @react-three/fiber 9.8.2, @react-three/postprocessing 3.2.2 y React 19, la plantilla compila con tsc --noEmit sin un solo error.

Para el sonido necesitas Python 3 con numpy, scipy y Pillow (este último lo usan los scripts de QA), además de ffmpeg.

3. Los modelos de Kenney

world.ts carga 26 modelos desde public/bridge/kenney/<nombre>.glb (tree_oak, lantern, stall-red, windmill, canoe…). No vienen en el repositorio. Si faltan, el código los salta sin romperse, pero el pueblo sale sin árboles ni puestos. Descarga los kits CC0 de Kenney que contengan esos nombres y renómbralos si hace falta.

4. Pedírselo a Claude

snippettext
Usa la skill cartoon-3d-short y haz un short sobre [tu historia real].

Claude empieza por el tema y los hechos con fuente, escribe el guion y espera tu visto bueno antes de animar.

Lo que no te cuenta el README

Es la configuración personal de su autor

SKILL.md lleva reglas que son preferencias del autor, no del método: "English only", nada de subtítulos, "Opus max verifies every check", rutas como ~/bridge-short/ o la herramienta SendUserFile, que no existe en una instalación normal de Claude Code. Edita esa sección antes de usarla. Si vas a narrar en español, cambia "English only" y recalcula el ritmo: los 3,7 palabras por segundo están medidos sobre narración en inglés.

Una historia nueva es reescribir código

La plantilla no es paramétrica. story.ts tiene el puente metido en constantes (TOTAL = 2025 fotogramas, 74 soldados, el instante exacto del chasquido en SNAP = 34.62), y build.ts y cast.ts describen ese pueblo y esos personajes. Para otra historia, Claude tiene que reescribir buena parte de los archivos. La skill le da las reglas y los valores, pero el trabajo de animación sigue ahí.

Rutas de Windows y mucho disco

bridge-stills.mjs tiene la ruta de Chrome escrita a fuego (C:/Program Files/Google/Chrome/Application/chrome.exe) y usa gl: "angle". En macOS o Linux tienes que cambiarla. Además, cada *bundle* de Remotion copia public/ (unos 1,3 GB en el proyecto del autor) a la carpeta temporal y no la borra: el autor cuenta que llenó 60 GB del disco del sistema y luego 110 GB en otra unidad. Define REMOTION_TMP en un disco grande desde el principio.

Tiempos de render

Según las notas del autor, un render 2K va a unos 4 fotogramas por segundo, unos 10 minutos para 67 s, y cada still a media escala tarda de 3 a 8 s tras unos 40 s de *bundle*. Necesitas una GPU decente: el render es WebGL de verdad.

Remotion tiene su propia licencia

La plantilla es MIT, pero Remotion no lo es del todo: es gratis para personas y empresas pequeñas, y las empresas más grandes necesitan una licencia de empresa. Revisa la licencia de Remotion antes de usarla en un trabajo para clientes.

Ojo con la carpeta references/: no es MIT

El README dice que el código y la documentación son MIT y que los fotogramas de referencia se incluyen "solo para estudio de estilo". Esos 38 fotogramas y 1.200 miniaturas salen de 20 shorts de otro canal de YouTube, sin nombrar, que el autor estudió para clonar su estilo. La licencia MIT de este repositorio no puede darte derechos sobre imágenes de un tercero, y el propio CONTEXT.md dice que ese material es "private study only: never upload, publish or send any of it anywhere", aunque esté publicado en un repositorio público.

Lo práctico:

  • Usa los informes con números (reports/*.md), que son texto propio del autor y bajo MIT.
  • No redistribuyas references/frames/ ni references/sheets/ en tu fork ni los metas en tus vídeos.
  • Respeta la regla que la skill trae de serie: historia, personajes y voz siempre tuyos. Copiar planos o personajes de otro canal es la forma más rápida de recibir una reclamación de copyright.

Si te interesa la parte legal de crear con IA, lo tratamos en riesgos legales de crear apps con IA.

Qué probamos y qué no

Instalamos las dependencias de Remotion en un proyecto limpio, copiamos la plantilla y comprobamos que compila sin errores de tipos con las versiones citadas arriba. Leímos todo el código de render, sonido y QA. No renderizamos el short: el entorno de pruebas que usamos no deja ejecutar el código del repositorio, así que los tiempos y las puntuaciones de calidad son los que publica el autor, no medidas nuestras.

Preguntas frecuentes

¿Claude Animated Shorts usa IA para generar el vídeo?

No. Claude escribe y ajusta el código; el vídeo lo dibuja three.js fotograma a fotograma dentro de Remotion. No hay Sora, Veo ni ningún generador de vídeo, y el sonido se sintetiza con numpy.

¿Necesito saber programar?

Para el primer short, bastante. Tienes que montar el proyecto de Remotion, colocar los modelos de Kenney, grabar o generar la voz con tiempos por palabra y revisar lo que Claude cambia en story.ts. La skill reduce el trabajo, no lo elimina.

¿Puedo hacer los shorts en español?

Sí, pero edita SKILL.md: la regla "English only" y el ritmo de 3,7 palabras por segundo vienen pensados para narración en inglés.

¿Qué alternativas hay?

Si prefieres maquetar el vídeo con HTML y CSS en lugar de 3D, mira HyperFrames. Si lo que necesitas es editar material grabado con ayuda de un agente, Concat trae un servidor MCP.

Conclusión

Claude Animated Shorts no es un botón de "hazme un short viral". Es un caso real documentado al detalle: cómo convertir un estilo visual en números, cómo repartir el trabajo entre agentes sin que se pisen y cómo montar en three.js una cadena de tinta, desenfoque y gradación que aguante a 2K. Si trabajas con Remotion o three.js, ink.ts, lensblur.ts y short_qa.py merecen la lectura aunque nunca hagas un short de dibujos.

El siguiente paso: clona el repositorio en tu carpeta de skills, edita las reglas personales de SKILL.md y pide a Claude un short sobre una historia real que conozcas bien.

// código fuente

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

Agentes de IA

guía · Guía completa de ECC para Claude Code · #8

AgentShield, el escáner de ECC, revisa CLAUDE.md, settings.json, MCP, hooks y agentes. Lo probamos con una configuración vulnerable y con el propio ECC.
  • Seguridad y revisión de código
  • Claude Code
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #7

Medimos cuánto contexto ocupa ECC con /ecc:context-budget --audit (unos 12.500 tokens en el perfil minimal) y cómo recortarlo: modelo, compactación y MCP.
  • Claude Code
  • Skills para tus agentes
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #6

Qué hacen los 28 hooks de ECC, cómo GateGuard frena la primera edición, cómo guardar y retomar sesiones y cómo funcionan los instincts del aprendizaje continuo.
  • Claude Code
  • Skills para tus agentes
leer artículo