Communitygithub.com

stage3d-shorts

Crea un corto animado vertical (1080x1920, 30 fps) con el estilo visual 'black stage' 3D, a partir de un guion con tiempos de palabras hasta un MP4 terminado. Úsalo para cualquier nuevo corto en este estilo, sin importar el tema.

¿Qué es stage3d-shorts?

Esta habilidad (skill) permite a un agente de IA generar cortometrajes animados verticales con un estilo visual 3D distintivo: un escenario oscuro con suelo espejo, figuras píldora blancas planas, accesorios dibujados con líneas de neón y un foco teatral que sigue al personaje. La cámara se mueve en 3D real y las palabras aparecen una a una como subtítulos. El kit visual ('kit/src/') es inmutable y contiene colores, efectos de lente, iluminación y curvas de cámara; cada video es un archivo de plan ('kit/plans/<nombre>/plan.js') que solo importa 'kit/src/api.js' y define qué hay en escena y cuándo. El sistema está diseñado para funcionar en la PC de Pimbo, donde el kit reside en 'C:\Users\Pimbo\work\anymation\stage3d\skill'. Requiere Node.js, npm, ffmpeg y Python con numpy y opencv. El agente debe seguir reglas estrictas: no editar el kit para un video individual, obtener los tiempos de las palabras del audio real, justificar cada movimiento de cámara, y verificar los fotogramas antes de renderizar. El pipeline incluye escribir el plan, generar audio, renderizar fotogramas clave, previsualizar, y finalmente crear el MP4 con QA automático.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pimboto/claude-skills/tree/HEAD/skills/stage3d-shorts

Preguntar en tu IA favorita

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

Documentación

stage3d shorts

Un escenario oscuro con suelo espejo. Figuras píldora blancas planas, accesorios dibujados con líneas de neón, un foco teatral sobre la persona, una cámara que se mueve en 3D real, una palabra de subtítulo a la vez. El estilo fue obtenido mediante medición inversa a partir de videos de referencia (material de estudio privado: nunca copiar su contenido, nombres o guiones) y luego mejorado.

Estado: v0.1. Probado en un clip de 9.7 s con dos estaciones (pricetag_demo) y una prueba de 5 s (test5). Aún no probado en un video de duración completa. Lea "Lo que el kit aún no tiene" antes de prometer una escena.

La idea

  • El kit es el estilo. kit/src/ contiene colores, brillo, lente, suelo, luz, curvas de cámara, subtítulos. Un video nunca lo edita.
  • Un video es un plan. kit/plans/<nombre>/plan.js dice qué hay en el escenario, cuándo sucede cada cosa y cómo se mueve la cámara. Solo importa kit/src/api.js. La compilación rechaza un plan que acceda al estilo.
  • Los números deciden, no las opiniones. Cada renderizado se mide con scripts/qa.py. Un video que falla no se entrega.

Dónde vive el kit

Esta habilidad es solo instrucciones. El código que dibuja el video y los archivos de referencia están en una carpeta en la PC de Pimbo: C:\Users\Pimbo\work\anymation\stage3d\skill (contiene kit/, references/ y una copia de este archivo). Cada ruta en esta habilidad es relativa a esa carpeta.

  • La carpeta anymation debe estar conectada a la conversación. Si no lo está, pídale a Pimbo que la conecte: sin el kit no se puede hacer ningún video, y nada aquí debe reconstruirse de memoria.
  • Pimbo no ejecuta scripts manualmente. Usted los ejecuta. Él da el tema o la carpeta del video, mira los fotogramas y aprueba.
  • Las entradas de un video provienen de su propio pipeline: anymation/v2/v8/<video>/ (script.json, asr_<lang>.json para los tiempos de palabras, premix_<lang>.wav para voz y música, events_<lang>.json).
  • Si puede ejecutar comandos en su PC, trabaje en la propia carpeta. Si solo tiene un espacio de trabajo en la nube: copie stage3d/skill dentro (deje fuera node_modules, out y dist), ejecute npm install dentro de kit/, escriba el plan y renderice fotogramas allí (aproximadamente 2 s cada uno sin tarjeta gráfica), muéstrele los fotogramas, luego escriba la carpeta kit/plans/<nombre>/ terminada de vuelta en su carpeta.
  • El renderizado final pertenece a su PC: su tarjeta gráfica es aproximadamente 20 veces más rápida que una máquina en la nube. Si no puede ejecutar comandos allí, deje un archivo .cmd en stage3d/skill que ejecute node scripts\make_video.cjs <nombre> --gpu --workers=4 desde kit, pídale que haga doble clic y que pegue lo que imprime. Lea las líneas de QA antes de dar el video por terminado.

Reglas que no son negociables

  1. Nunca edite kit/src/ para que funcione un solo video. Si falta un accesorio o un tipo de toma, agréguelo al kit como parte reutilizable (vea references/PLAN_GUIDE.md, "Agregar un accesorio") y vuelva a verificar pricetag_demo después.
  2. Cada número de fotograma en un plan proviene del audio real (tiempos de palabras), nunca de una suposición.
  3. Cada movimiento de cámara tiene una razón que se puede decir en una oración. Escriba esa oración como un comentario encima del movimiento.
  4. Mire los fotogramas antes de renderizar un clip. Mire la imagen, no el código de salida.
  5. Diga qué se midió y qué se asumió. Si no verificó algo, dígalo.
  6. Una persona escucha el audio antes de que salga un video: estos scripts establecen niveles mediante números.

Pipeline

Trabaje dentro de kit/. Primera vez en una máquina: npm install (three, esbuild, playwright-core; usa el Chrome o Edge instalado, no se descarga nada más). El renderizado necesita ffmpeg en el PATH; QA necesita Python con numpy y opencv (pip install numpy opencv-python); los scripts de audio necesitan scipy.

PasoQuéComando o archivo
1Guión y voz, con un tiempo para cada palabrafuera de esta habilidad; resultado: words.json = [{ w, t0, t1, line }], segundos
1bVerifique cada hecho del guión el mismo día, antes de grabar la vozbúsqueda web; escriba SOURCES.md junto al plan (ejemplo: plans/no_trick/SOURCES.md)
2Divida el guión en estaciones: una oración o idea cada unanotas al inicio de plan.js
3Escriba el plan: construir, animar, cámarakit/plans/<nombre>/plan.js; comience desde pricetag_demo
4Audio: mezcla base más efectos en los eventoskit/plans/<nombre>/make_audio.py -> audio.wav
5Verifique y compilenode scripts/build.cjs <nombre>
6Fotogramas en los fotogramas clave; corrija el encuadre; repitanode scripts/render.cjs <nombre> stills 0,17,62,88
7Véalo moverse con sonidoabra kit/dist/<nombre>/preview.html en un navegador
8Renderice, codifique, QA de una veznode scripts/make_video.cjs <nombre> --gpu --workers=4
9Lea las líneas de QA; un FALLO significa corregir y repetirkit/out/<nombre>/logs/qa.log, qa.json

El paso 8 imprime una línea por paso. En una PC con tarjeta gráfica, un video de 5 s toma aproximadamente 10 s; sin una (omitiendo --gpu) cada fotograma toma aproximadamente 2 s, así que renderice allí solo lo necesario.

Escribir un plan, en resumen

Guía completa y lista de partes: references/PLAN_GUIDE.md. El ejemplo trabajado es kit/plans/pricetag_demo/plan.js.

  • El escenario es una fila de estaciones separadas 14 m. Una oración o idea por estación. La cámara permanece en una estación para una toma y hace un barrido panorámico a la siguiente entre oraciones.
  • build(stage) crea las cosas y las coloca: stage.station(i).add(thing). Las figuras reciben un foco: stage.station(i).spotlight(figure).
  • animate(f, o) establece dónde está todo en el fotograma f. Debe ser una función pura de f: los fotogramas se renderizan en cualquier orden y en paralelo. Sin estado de un fotograma al siguiente, sin Math.random, sin reloj.
  • Las cosas aparecen en su palabra: pop(thing, f, wordFrame). Un número que importa se ejecuta mientras se habla de él. Algo que aterriza recibe un anillo de suelo (pulse), un breve destello (flare) y un sonido.
  • Colores solo por nombre. Oro = la cosa valiosa. Rojo = precio, costo, peligro. Blanco = personas y etiquetas neutrales.
  • El texto que cambia (un contador) necesita maxChars para que su cuadro no se redimensione.

Cámara, en resumen

Reglas completas con las mediciones detrás: references/CAMERA_RULES.md.

  • Una toma tiene un movimiento, a veces dos o tres. Entre movimientos la cámara sostiene (el kit agrega un desplazamiento lento).
  • Solo existen tres tipos de movimiento: hook (acercamiento inicial, desde el fotograma 0), reframe (20-28 fotogramas, entre dos oraciones, aterriza unos fotogramas antes de que aparezca la nueva cosa), slow (un acercamiento u órbita a lo largo de una toma completa).
  • Mientras un gráfico se anima, la cámara sostiene. Una lista obtiene un recorrido; una afirmación más amplia obtiene un alejamiento; un objeto para una línea larga obtiene una órbita lenta.
  • Una vista 3/4 (guiñada alrededor de 35-40 grados) es la que muestra profundidad. Úsela cuando un segundo objeto necesite espacio.
  • Los barridos panorámicos solo entre ideas. Cada uno necesita un silbido en el audio que comienza aproximadamente 3 fotogramas antes.

Puertas de calidad

scripts/qa.py falla el video si: falta un fotograma o está congelado; el fondo no es el negro elevado; el hook o un reframe no están cargados al frente; la cámara no sostiene entre movimientos; un barrido panorámico no se mueve o no se oscurece; el MP4 no es h264 / yuv420p / BT.709, tiene el número incorrecto de fotogramas, o su audio falta o tiene la longitud incorrecta.

No verifica el gusto, el recorte en los bordes del fotograma, o que los subtítulos digan las palabras correctas. Esos se verifican en los fotogramas, a ojo, antes del renderizado: nada importante cortado por el borde del fotograma, la banda de subtítulos (75-83 % de la altura) libre de líneas brillantes, figuras entre el 25 % y el 85 % de la altura (la lente estira las cosas cerca de los bordes).

Después de cualquier cambio en kit/src/: reconstruya pricetag_demo, renderice los fotogramas 0,17,88,150,174,236 y compárelos con references/frames/. En renderizado por software deben coincidir exactamente; en una tarjeta gráfica, dentro de aproximadamente 1 nivel.

Lo que tiene el kit

Figura (persona píldora con auriculares), píldora de etiqueta, tarjeta con una etiqueta y un valor grande, token, cofre que se abre (oro, o uno gris liso para una multitud de cofres), brújula redonda con aguja, tira de brújula de una pantalla de juego, marco de contorno (una pantalla, una miniatura), dado, botón de reproducción, marcas de conteo, guía discontinua, imagen (un SVG o PNG en blanco y negro dibujado como luz), anillo de suelo, línea de suelo discontinua, motas flotantes, foco teatral con piscina de suelo y sombra, piscinas de suelo de colores, halo, rayos, chispas, barrido panorámico con desenfoque de movimiento, subtítulos, una biblioteca de sonidos (silbido, tic, ding, golpe sordo, clunk, chisporroteo, burbujeo) y un mezclador que coloca un archivo de voz y un archivo de música debajo.

Dos planes para leer: pricetag_demo (10 s, dos estaciones, el estilo aprobado) y no_trick (47 s, cinco estaciones, un corto completo con su voz, música y fuentes). starts_clean (62 s, seis estaciones) es blanco hasta un único pago de oro, como lo piden las reglas del guión de Pimbo. avatar no es un video: crea fotogramas para una foto de perfil.

Lo que el kit aún no tiene

  • Un recorrido a lo largo de una fila de cosas (para listas), barras y gráficos de líneas.
  • Más de un foco en una estación: no probado (las motas están iluminadas por como máximo dos focos a la vez). Varias figuras en una estación funcionan con un foco y las demás atenuadas (no_trick, estación 2).
  • Fundidos o cortes: la única transición es el barrido panorámico.
  • Primeros planos: la cámara necesita el suelo debajo de su sujeto dentro del fotograma y pierde su objetivo a menos de aproximadamente 2 m. Una imagen más cercana se recorta de una más amplia (plans/avatar).
  • Más de los tres tipos de movimiento, y cualquier giro de cámara.
  • Voz, música y tiempo de palabras: vienen de fuera (el pipeline v2/v8 de Pimbo los crea).

Cada uno de estos debe construirse en el kit y probarse en un video real antes de que un plan pueda usarlo.

Archivos

RutaQué es
kit/src/El estilo. api.js es el único archivo que importa un plan
kit/plans/<nombre>/Un video: plan.js, words.json, make_audio.py, audio.wav
kit/scripts/build.cjs, render.cjs, encode.cjs, make_video.cjs, qa.py
kit/audio/sfx.pyEfectos de sonido y mezclador
references/STYLE_BIBLE.mdCada número del estilo, etiquetado medido, nuestro o suposición
references/CAMERA_RULES.mdCómo se edita la cámara, con las mediciones
references/PLAN_GUIDE.mdCómo escribir un plan; cada función de api.js; agregar un accesorio
references/KNOWN_ERRORS.mdErrores ya cometidos una vez, y lo que ahora previene cada uno
references/frames/Fotogramas de destino de pricetag_demo

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados