Communitygithub.com

gbax316/shorts-director

Dirige un corto vertical sin rostro desde la idea hasta el archivo masterizado terminado, mejorando con cada ejecución. Elige un formato, escribe el episodio en una sala de guionistas (tres premisas juzgadas como el comprador), lo narra, revisa el animatic y decide latido a latido cómo se crea cada momento.

¿Qué es shorts-director?

Este skill actúa como un director de producción para videos cortos verticales sin rostro, automatizando cada etapa del flujo de trabajo desde la concepción hasta el masterizado. El skill selecciona un formato (como un sketch con diálogo sincronizado o un mini documental fotorrealista), genera tres premisas divergentes para que el usuario elija como 'comprador', escribe el guion, produce la voz en off, crea un animatic con imágenes estáticas y etiquetas, y luego decide latido a latido si cada momento será dibujado con código en Remotion, un recorte de una imagen generada, un clip generado, o una pista del motor. Incluye modos específicos como 'series' para gestionar biblias de series, 'writers-room' para la sala de guionistas, 'produce', 'sound', 'finish', 'bakeoff' para comparar modelos, y 'improve' que evalúa cada ejecución y propone mejoras al skill basadas en lecciones aprendidas. Compatible con plataformas como Claude Code, se activa con frases como 'make a short' o 'next episode', pero no debe usarse para editar videos existentes o explicadores puramente dibujados con código.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gbax316/shorts-director/tree/main/.claude/skills/shorts-director

Preguntar en tu IA favorita

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

Documentación

Director de cortos

Un corto se juzga en dos segundos por alguien que no le debe nada. Todo en esta habilidad existe para que el primer corte que entregues sea uno que el dueño publicaría: la idea elegida de tres, las palabras visibles en pantalla además de oídas, ningún fallo en el encuadre que ellos detecten antes que tú, y una mezcla de sonido que puedan reproducir en un teléfono en un danfo. La calidad es lo primero. El costo se muestra antes de cada gasto, nunca se usa como límite.

La habilidad dirige; los motores del repositorio hacen el trabajo. Las pistas del motor (el kit de Remotion, las herramientas de clips e imágenes, las bibliotecas especializadas, la cámara de collage) y las herramientas añadidas desde entonces (mouth_sync, las tarjetas compartidas, el chunker de subtítulos, las comprobaciones) son rutas de renderizado que esta habilidad selecciona, compás a compás, en lugar de una sola pista por video.

Antes de todo: lee la configuración y la biblia

La identidad reside en la configuración, nunca en la habilidad. Lee director.config.json en la raíz del repositorio para la marca, la marca de esquina, las personas que una película puede nombrar, el etiquetado de enlaces, las reglas internas, los proveedores y sus precios, y el objetivo de masterización. La identidad visual (colores, fuentes, logotipo) está en remotion/src/brand.ts y remotion/src/fonts.ts. Si el corto pertenece a una serie, lee su biblia en ai-shorts/series/<series>/BIBLE.md antes de escribir una línea; si es un nuevo canal o elenco, el modo de serie escribe una primero. Luego lee las últimas entradas de RUNS.md y LESSONS.md, porque los fallos de la última ejecución son los más baratos de evitar en esta.

Los modos

ModoSu trabajoLeer
seriesla biblia para un elenco recurrente o un estilo de canalmodes/series.md
writers-roomtres premisas divergentes juzgadas como el comprador, luego el guionmodes/writers-room.md
producevoz, animática, imágenes fijas, clips, bocas, composiciónmodes/produce.md
soundbases, señales, la mezcla y masterizaciónmodes/sound.md
finishel máster, la copia para teléfono, la revisión de texto, el paquete para publicaciónmodes/finish.md
bakeoffprobar modelos entre sí antes de que uno se convierta en el predeterminadomodes/bakeoff.md
effects/effects <nombre>: previsualizar un efecto, colocarlo en un compás o construir uno nuevo en la bibliotecamodes/effects.md
improvedespués de cada corto: puntuar la ejecución, registrar las lecciones, proponer cambios en la habilidadmodes/improve.md

Un nuevo corto los ejecuta en orden: series (solo si falta la biblia), writers-room, produce, sound, finish, improve. El dueño puede entrar en cualquier modo por nombre, y una solicitud que claramente pertenece a un modo (una nueva toma de voz, una corrección de subtítulos, un nuevo gancho) va directamente allí.

El carril rápido. Cuando la biblia de la serie existe, el formato está probado y los motores son conocidos, no omitas nada pero acorta todo: una sola pasada de premisa en lugar de una larga, e imágenes fijas reutilizadas de la serie donde encajen. Las compuertas y las comprobaciones permanecen exactamente como están; solo las rondas se reducen.

Las compuertas que se mantienen en cada ejecución

Estos son los puntos donde va la mirada del dueño, en orden, y donde el trabajo se detiene hasta que ellos respondan. Cada uno es barato de cambiar en ese punto y caro de cambiar después.

  1. La premisa. Tres, escritas y juzgadas como el comprador, con una elección y el motivo. Nada se expresa antes de que se elija una.
  2. La voz. Líneas en las palabras del dueño donde ellos las dieron. Para cualquier cosa en pidgin o un nombre local, audiciones que ellos eligen de oído (references/voice.md). Una toma seleccionada se coloca exactamente, nunca se regenera.
  3. La animática. Imágenes fijas en la línea de tiempo de la voz real con los chistes dibujados en código, subtítulos y etiquetas rojas donde irán los clips. No se genera ningún clip antes de que se apruebe la animática.
  4. El gasto. Cada paso de generación indica sus créditos o dólares primero (references/stills-and-clips.md), y el total se informa después.
  5. El corte. El dueño ve el corte preliminar antes de la masterización, y el archivo terminado antes de que se publique nada.

Entre las compuertas, revisa tu propio trabajo como lo describe references/qa.md, para que el ojo del dueño se gaste en el gusto y nunca en un fallo que un escaneo podría haber detectado.

Formatos

Un formato trae su propia gramática (cómo se ejecutan los compases), su propio mundo visual y sus propias rutas de renderizado predeterminadas. Los probados hasta ahora tienen cada uno una referencia:

  • references/formats/skit.md: un elenco recurrente en diálogo (probado por Akpos y Segs, episodios 1 y 2)
  • references/formats/documentary.md: un narrador sobre escenas fotorrealistas con figuras de fuentes (probado por el minidocumental 1 de Qodeup)

Los formatos del motor también siguen disponibles: explicadores dibujados en código a través de make-short y vidtsx-2d-generator, collage a través de make-vox. El director puede enrutar un corto completo a uno de ellos, o tomar prestado un compás de uno.

Cuando el formato solicitado aún no está probado

Si el dueño pide un tipo de corto que ninguno de los formatos cubre (una lista, un antes-y-después, un objeto parlante, un resumen de noticias), dilo claramente en lugar de forzarlo al formato más cercano; una gramática de sketch en un resumen de noticias produce algo que se siente extraño de una manera que notarán. Ofrece dos caminos. El primero es configurarlo correctamente: ejecútalo como una ejecución de prueba, y una vez que se publique, escribe references/formats/<nombre>.md a partir de lo que la ejecución probó, a través de os-skillify, para que la siguiente comience desde una gramática en lugar de una suposición. El segundo es hacerlo una vez con el formato más cercano como andamio, con las brechas nombradas, y no guardar nada. Si el mismo formato nuevo aparece una segunda vez, toma el primer camino; un formato que se improvisa constantemente nunca obtiene una gramática, y la habilidad reduce silenciosamente lo que el dueño le pide.

Cómo mejora

Cada corto termina en el modo improve. Puntúa la ejecución contra los resultados en references/outcomes.md, lo registra en RUNS.md, escribe lo aprendido en LESSONS.md, y cuando un fallo ha ocurrido dos veces o una técnica se ha demostrado, propone el cambio a esta habilidad en términos generales, como un diff que el dueño aprueba. Git es la forma de retroceder.

Referencias

  • references/outcomes.md: qué debe producir la habilidad, con números, cómo se verifica cada uno y los bucles que lo mejoran
  • references/render-routing.md: elegir, por compás, entre código, un recorte, un clip generado y las pistas del motor
  • references/voice.md: voces, casting, audiciones, pidgin y nombres, colocación de una toma seleccionada
  • references/stills-and-clips.md: generar imágenes fijas y clips, indicaciones que mantienen la identidad, repeticiones, precios
  • references/mouths.md: redibujar bocas en clips generados con mouth_sync, incluyendo ajustes por toma
  • references/facts.md: la compuerta de hechos para cualquier cosa declarada como verdadera en pantalla
  • references/effects.md: los trabajos que puede tener un compás, el efecto que sirve a cada uno, y las reglas de moderación que evitan que un corto se convierta en un carrete de demostración
  • references/qa.md: las comprobaciones entre compuertas, y lo que cada una ha detectado antes
  • references/formats/: un archivo por formato probado

Habilidades relacionadas

  • make-short, vidtsx-2d-generator: la pista de explicador dibujado en código y sus reglas de bloqueo, utilizada como ruta de renderizado
  • make-vox: la pista de collage
  • make-ai-short: la pista generativa, cuya disciplina de clips esta habilidad continúa
  • suggest-sfx: audiciones de efectos de sonido, llamadas desde el modo sound
  • os-writing (Personal OS): ganchos y subtítulos para publicación, llamados desde el modo finish
  • os-skillify (Personal OS): escribir una nueva referencia de formato después de su ejecución de prueba

Individual skills in this repo

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

gbax316/make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, ~35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to "make an AI video short", "make an ai short", "make a blue-man video", or any short where the pixels come from a VIDEO MODEL — not TSX animation (that is make-short) and not layered collage (that is make-vox). Defers model choice re-litigating to ai-shorts/IDEAS.md, TSX crash rules to vidtsx-2d-generator, SFX taste to suggest-sfx + brand §7. For a NEW short (writers' room, dialogue skits, documentaries, mixed render paths), start with shorts-director, which calls this track as an engine.

gbax316/vidtsx-2d-generator

Generate production-ready 2D TSX video files for VidTSX (Remotion-based) from a shot, scene, or video description. Use whenever the user wants to create or generate a VidTSX video, a 2D TSX shot or scene, an animated clip, title card, or rendered motion graphic — including when they describe a visual animation they want built, or say "make a shot", "build this scene", "generate the TSX", or "turn this into a video". Covers the mandatory file structure and composition config, dimension presets (horizontal/vertical/square), six style presets (minimalist, memphis, neo-brutalism, glassmorphism, neon, corporate), and the hard rules that keep renders from crashing, covering frame-based animation only (no useState/useEffect/setTimeout), strictly monotonic interpolate ranges, Easing.bezier not wrapper syntax, and the chroma-js and @remotion/paths import gotchas. Not for 3D/three.js compositions, general React work, or editing video files.

Skills relacionados