Envía formatos, una skill y un servicio (paso 12 del curso)
Tres movimientos convierten un buen clip en un negocio repetible: exporta cada formato desde una sola línea de tiempo, empaqueta el pipeline como una skill para que el próximo video sea una oración y, si el usuario lo desea, véndelo. Trabaja en la raíz del proyecto cinematográfico. Argumentos, mostrados una vez:
Los archivos de esta skill viven en ${CLAUDE_SKILL_DIR} (las plantillas en assets/).
1. Reencuadra por formato, nunca recortes
Las escenas se dibujan contra el layout L (ctx.L en la fábrica, c.L en un dibujo), así que una línea de tiempo renderiza 9:16, 1:1, 16:9 (y 4:5) con texto y UI colocados para cada forma.
| Formato | Tamaño | Etiqueta |
|---|---|---|
9x16 | 1080x1920 | Reels, TikTok, Shorts |
1x1 | 1080x1080 | X / feed |
16x9 | 1920x1080 | YouTube, sitio |
4x5 | 1080x1350 | feed retrato |
| Herramienta | Uso |
|---|---|
L.u | unidad de tamaño: 1 a 1080 px de lado corto; 120 * L.u se lee del mismo tamaño en cada formato |
L.S | el rectángulo seguro {x, y, w, h} de studio.json safe[fmt] (márgenes de la UI de la plataforma) |
L.pos(ax, ay) | un punto dentro del rectángulo seguro, ax, ay de 0 a 1 |
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default }) | valores por formato: clave exacta, luego orientación, luego predeterminado |
L.split('auto', ratio, gap) | dos regiones: apiladas en retrato y cuadrado, lado a lado en paisaje |
L.cols(n, gap) / L.rows(n, gap) | columnas o filas dentro del rectángulo seguro |
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step }) | el tamaño más grande que cabe en un ancho (lib/layout.js + lib/draw.js); step: 16 para fuentes de mapa de bits |
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis }) | líneas para texto multilínea, sin cortar nunca dentro de una sílaba Hangul (lib/draw.js) |
draw(g, lt, c) {
const { L, brand } = c;
const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u); // título | producto
const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
fitFontSize(g, 'MAKE IT MOVE.', a.w, (s) => font(s, brand.fonts.display, 400)));
kinetic(g, 'MAKE IT MOVE.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
drawProduct(g, b, lt, c); // la UI del producto llena la región b en cada formato
}
Reglas: sin píxeles literales; contenido clave dentro de L.S; el mismo momento ocurre al mismo tiempo en cada formato (solo cambian la colocación y el tamaño); un formato que parece un recorte de otro es un P1 en la crítica. Ajusta los márgenes safe en studio.json, no en el código. Previsualiza cada formato con npm run preview (F cambia formatos, G muestra las guías de seguridad).
2. Revisa cada formato
El bucle de crítica se ejecuta en el formato principal; antes de la final, ejecuta al menos una ronda por cada otro formato, cada una con su propia evidencia (aproximadamente 115 s de tiempo de herramienta por pase en vivo y 85 s por pase --video, medidos en una película de 12 a 20 s):
node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5 # aproximadamente 20 s; luego: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9 # película en vivo -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4 # render mezclado -> out/review/16x9/video/
Registra cada una como su propia ronda (## Ronda <n> — 16x9 — ...). La puerta lee la última ronda, así que termina con una ronda aprobada.
3. Renderiza, mezcla, entrega
Estos toman minutos: el demo de 12 s se renderiza en aproximadamente 4 min para tres formatos a 60 fps (aproximadamente 20 s por segundo de película), mix toma 40 a 80 s y deliver aproximadamente 40 s. Inicia npm run build, render:final, mix y deliver con la opción run_in_background de la herramienta Bash y un registro, consulta el registro (tail -n 3), lee el resultado después de la línea exit, y nunca esperes en primer plano más de aproximadamente 2 minutos; agrega --chunk 10 a una final de tres formatos o más de aproximadamente 30 s. El runbook de motion-reel ("Comandos largos") tiene el patrón.
| Paso | Comando | Salida |
|---|---|---|
| todo, en orden | npm run build | score (si falta), sfx, render final de todos los formatos, mix, deliver |
| render final (con puerta) | npm run render:final | out/<fmt>/silent.mp4, poster.png, render.json para cada formato en studio.json formats |
| mezcla y mux | npm run mix | out/score.wav, out/<fmt>/final.mp4, out/final.mp4 (principal), out/poster.png |
| controles y paquete | npm run deliver | out/deliver/<slug>_<fmt>.mp4 + póster + cada página de la hoja de contactos (<slug>_<fmt>_contact.png, luego _contact-2.png ...), out/deliver/manifest.json, docs/production.json |
deliver.mjs verifica, por formato, out/<fmt>/final.mp4 contra el studio.json ACTUAL: recuento de fotogramas (duración x fps), el tamaño del formato, fps y duración exacta (un corte renderizado antes de una edición de duration o fps falla como render obsoleto; un render borrador o escalado también falla), sonoridad integrada y pico verdadero contra audio.lufs +- audio.lufsTolerance y audio.truePeak; tramos de silencio (un tramo de 1 s o más por debajo de -50 dB falla como silencio, por ejemplo silencio 2.2 s en 00:02.1, a menos que comience en los primeros 0.3 s, comience en el último segundo o esté dentro de un intervalo critique.allowSilence); tamaño de archivo contra deliver.maxBytes (predeterminado x: 536,870,912 bytes = límite de carga de 512 MB de X; agrega los límites de otras plataformas allí); póster presente; la costura del bucle para películas en bucle; y la puerta de crítica. Advierte (sin fallo) cuando las fuentes de la película son más recientes que el render. Sale con 1 y nombra cada verificación fallida; un final.mp4 ilegible también falla. Con --json, un fallo imprime una línea { ok: false, error, failed: [...] }, también cuando la ejecución no puede comenzar (un studio.json inválido, un formato desconocido, una bandera incorrecta).
--format 1x1 re-entrega solo ese formato y mantiene los archivos entregados y las entradas del manifiesto de los demás (carriedOver); una puerta fallida retira cada archivo entregado. docs/production.json registra título, formatos, duraciones, sonoridad, rondas, últimos puntajes, el nivel de esfuerzo (de CLAUDE_EFFORT cuando está configurado) y versiones de herramientas.
| Verificación fallida | Solución |
|---|---|
fotogramas o duración incorrectos, o render obsoleto | vuelve a ejecutar npm run render:final; nunca entregues un render parcial |
| sonoridad o pico verdadero | /motion-studio:sound-design (tabla de informe de mezcla) |
silencio | una pista termina temprano o un fondo suena bajo nada: regenérala (npm run score, sfx, voice), npm run mix, entrega de nuevo |
| tamaño superior al límite | node tools/render.mjs --format <f> --final --crf 18 luego npm run mix de nuevo |
| póster faltante | establece studio.json poster (segundos) o elimina --no-poster |
| puerta | /motion-studio:critique-loop |
Informa al usuario: cada archivo en out/deliver/, los números por formato del manifiesto, los puntajes de la última ronda y qué mejorarías a continuación.
4. Empaqueta el pipeline como tu propia skill
Para que el próximo video sea una oración (/acme-reel video de lanzamiento para modo oscuro, 20 s, vertical):
- Elige el nombre:
<marca>-reel, minúsculas, dígitos y guiones. - Crea
.claude/skills/<marca>-reel/SKILL.mden el repositorio de la marca (ámbito del proyecto, compartido a través de git) o en~/.claude/skills/<marca>-reel/SKILL.md(personal). Comienza desde${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md(assets/brand-skill-template.md). - Complétalo desde este proyecto, no de memoria: valores de marca de
studio.json,docs/style_guide.md, eldocs/shotlist.mdaprobado como patrón de ritmo narrativo, y las lecciones endocs/review_log.md(lo que el crítico seguía señalando se convierte en una regla estricta). Copia el logotipo en.claude/skills/<marca>-reel/assets/. - Mantén la descripción por debajo de aproximadamente 230 caracteres con frases de activación concretas, el cuerpo por debajo de aproximadamente 200 líneas.
- Pruébalo en una sesión nueva con una solicitud real y verifica que solo pregunte por lo que cambia por video.
- Para compartir más allá de un repositorio, publícalo como un plugin (un repositorio con
.claude-plugin/plugin.jsonyskills/<nombre>/SKILL.md), de la misma manera quebuildwithhanif/claude-animation-skilly este plugin están publicados.
5. Conviértelo en un servicio (opcional)
${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) es una oferta para rellenar: qué está incluido (música, una mascota en cualquier estilo, características del producto, una oferta al final, cualquier idioma, hasta 3 ediciones), formatos, tiempo de entrega, qué proporciona el cliente, derechos y divulgación, y precios. Ancla de precio: Tony Dinh informó haber pagado aproximadamente $1,000+ por un video de lanzamiento similar un año antes de hacer uno con Opus 5.5 en menos de 30 minutos (https://x.com/tdinh_me/status/2103703135902740699). Ayuda al usuario a rellenarlo; no lo publiques ni lo envíes por él.
Siguiente: comienza la próxima película con /motion-studio:motion-reel, o la nueva skill /<marca>-reel del usuario.