Plantillas de Reels
Quince plantillas Remotion basadas en datos (1080x1920, 60 fps) se incluyen con esta habilidad en assets/reels-kit/. Un video es un único archivo de trabajo JSON: elige una plantilla, completa sus propiedades, renderiza. No escribes React para un trabajo normal.
Las rutas que comienzan con reels/ están en la carpeta de trabajo, no en esta habilidad. Nunca edites archivos dentro de la carpeta de la habilidad para un trabajo.
Se ejecuta sin supervisión. Esta habilidad está diseñada para agentes autónomos. El solicitante es quien inició el trabajo: un agente orquestador, un pipeline o una persona. Toma cada decisión siguiendo las reglas de este archivo y nunca te detengas para pedir aprobación de un paso. Detente solo ante un bloqueo que no puedas resolver (una herramienta faltante, medios faltantes o ilegibles, un render que sigue fallando), e infórmalo. Cada trabajo termina con un informe (sección 4).
0. Configurar el espacio de trabajo
Hazlo una vez por proyecto, antes del primer trabajo.
- Verifica las herramientas: Node.js 18 o superior (
node -v), yffmpegyffprobeen el PATH. Si falta alguna, detente e infórmalo como un bloqueo. No instales software del sistema tú mismo. - Si la carpeta de trabajo ya tiene
reels/render.mjs, usa ese espacio de trabajo y salta a la sección 1. - De lo contrario, copia la carpeta
assets/reels-kit/de esta habilidad areels/en la carpeta de trabajo (por ejemplocp -R <directorio-habilidad>/assets/reels-kit reels), luego ejecutanpm installdentro dereels/. - Crea las carpetas
reels/public/(medios) yreels/jobs/_local/(trabajos temporales). Si la carpeta de trabajo es un repositorio git, agregareels/node_modules/,reels/public/,reels/out/,reels/exports/yreels/jobs/_local/a su.gitignore.
El espacio de trabajo tiene render.mjs (renderiza un trabajo), clean.mjs (libera espacio en disco, ver sección 6), src/ (plantillas y el kit compartido), jobs/examples/ (un trabajo de ejemplo por plantilla), public/<nombre>/ (medios de entrada de cada trabajo), out/stills/ (imágenes de control de calidad) y exports/<nombre>/ (videos terminados de cada trabajo).
Preferencias
Este repositorio no contiene los gustos de nadie. El estilo del texto, la fuente, el color de acento, el tono del texto, los idiomas, la música y el formato principal provienen del resumen del solicitante y de lo que ya sabes sobre la marca, nunca de un valor escrito en las plantillas o en este archivo. Cuando el resumen indique una preferencia, aplícala en el archivo de trabajo. Cuando no lo haga, usa los valores predeterminados de la plantilla y menciónalos en el informe. No escribas la preferencia de una persona o marca en las plantillas, los trabajos de ejemplo o esta habilidad.
1. Elegir la plantilla
Comienza con el conjunto social nativo cuando el video debe sentirse como algo que una persona publicó. Usa el conjunto de anuncios cuando el metraje por sí mismo lleva el video.
Social nativo (una interfaz que el espectador ya conoce es el gancho)
| Plantilla | Úsala cuando | Necesita |
|---|---|---|
ChatStory | Una historia contada como un hilo de mensajes de texto, luego la revelación del producto | Mensajes (+ una foto del producto para enviar), clips de recompensa |
NotesList | Una lista de notas que se escribe sola: "regalos que fracasaron vs. el que ella guardó" | Título + 1 a 7 líneas, clips de recompensa |
SearchHook | La pregunta del cliente escrita en una barra de búsqueda, respondida por el metraje | Una consulta (+ sugerencias), 1+ clips |
NotificationStack | La pantalla de bloqueo se llena de pedidos, mensajes, reseñas: prueba social y FOMO | 1 a 6 notificaciones, fondo, clips de recompensa |
PolaroidDump | Álbum de fotos estilo scrapbook con leyendas escritas a mano | 2 a 8 fotos |
Ranking | Ranking ciego: los elementos caen en una lista numerada, el #1 al final | 2 a 6 clips, una etiqueta y rango cada uno |
PollSticker | Una encuesta en historia sobre el metraje: dos opciones, un toque, el resultado | Una pregunta, 2 opciones con porcentajes, clips |
Formatos publicitarios (metraje primero, texto encima)
| Plantilla | Úsala cuando | Necesita |
|---|---|---|
BeatCutAd | Predeterminada para un anuncio de producto cortado del metraje: varias tomas, gancho, CTA | 1+ clips de video |
UgcCaptions | Una persona habla a cámara; subtítulos palabra por palabra | 1 clip con voz + tiempos de palabras |
Listicle | "3 razones por las que", consejos, características, pasos | 2 a 7 clips, uno por punto |
BeforeAfter | Una transformación o comparación (mode: wipe o split) | 2 clips o fotos |
ProductSlideshow | Solo existen fotos del producto, o un catálogo rápido; etiqueta de precio opcional | 2+ fotos o clips |
Testimonial | Prueba social: tarjetas de reseña con estrellas | 1 clip de fondo + textos de reseña |
CommentReply | Responder a una objeción o pregunta frecuente; la burbuja de comentario es el gancho | 1+ clips + el comentario |
OfferPromo | Oferta, código de descuento, fecha límite | 1+ clips + la oferta |
Si el resumen no encaja en ninguna, consulta la sección 7. No fuerces una plantilla a algo que no es.
La habilidad oficial de Remotion (remotion-best-practices, instalada por separado con npx skills add remotion-dev/skills --skill remotion-best-practices) es la referencia para escribir código Remotion. Si no está instalada, usa la documentación de Remotion en https://www.remotion.dev/docs. Para hacer un video en este repositorio, esta habilidad prevalece donde difieren: crea un archivo de trabajo en lugar de un nuevo proyecto o composición, verifica imágenes de control en lugar de abrir Studio, y renderiza con render.mjs una vez que las imágenes de control pasen, sin esperar a que te lo pidan.
2. Construir el trabajo
- Elige el nombre del trabajo (minúsculas, dígitos y
-, por ejemploxmas-ornament). Es elnamedel archivo de trabajo, la carpeta de entradareels/public/<nombre>/y la carpeta de salidareels/exports/<nombre>/. Copia solo los archivos que usa este trabajo enreels/public/<nombre>/, y deja los originales donde están. Anota en el informe de dónde vino cada entrada, y si la copia enpublic/es la única (archivos descargados o generados). Escribe cadasrccomo<nombre>/<archivo>. Ejecutaffprobeen cada archivo para obtener su duración. Los medios nunca se confirman:public/está en gitignore, por lo que las rutas en los trabajos de ejemplo (footage.mp4,music.m4a,demo/…) son marcadores de posición hasta que pongas tus propios archivos allí. - Observa el metraje antes de colocar texto: extrae un fotograma por toma (
ffmpeg -ss <t> -i <archivo> -frames:v 1) y anota dónde está el producto. - Lee
reels/jobs/examples/<Plantilla>.json. Enumera cada propiedad que toma esa plantilla. Cópialo areels/jobs/<trabajo>.jsony edítalo. Usareels/jobs/_local/para un trabajo que debe permanecer fuera de git.
Archivo de trabajo:
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<lang> se fusiona sobre props, por lo que contiene solo las cadenas traducidas. Las matrices de objetos se fusionan elemento por elemento (null conserva el elemento base); las matrices de cadenas se reemplazan.
Propiedades que comparten todas las plantillas:
hook:{ lines (1-3), band, size, duration }. Se muestra desde 0 s, por defecto 2.2 s.cta:{ lines, button, band, size, duration }. Se muestra durante los últimosdurationsegundos, por defecto 2.5. Otros subtítulos terminan cuando comienza.music:{ src, volume }. Se desvanece al final. Usa aproximadamente 0.15 debajo del habla.brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }.outline(el predeterminado) yboxson estilos publicitarios llamativos.captiones el aspecto nativo de subtítulos en la aplicación: texto blanco en mayúscula y minúscula en un cuadro oscuro redondeado, en la parte superior de su banda, que aparece gradualmente; escríbelo como una línea de historia en primera persona, 2 líneas de hasta 30 caracteres.- Un clip:
{ src, start (s desde el origen), duration (s en pantalla), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }.transitiones cómo llega ese clip.
Un clip también admite una cámara simulada: zoom (1-2.5, acercamiento que mantiene el punto de focus en su lugar), tilt (grados, -15 a 15, un ángulo holandés) y push (0-0.6, la cámara se lanza hacia adelante con un breve desenfoque cuando llega el clip, luego se estabiliza).
Una propiedad que el trabajo omite está desactivada: un trabajo sin hook no tiene gancho, independientemente de lo que muestre el ejemplo.
src es una ruta dentro de public/ o una URL https. Un .jpg/.png/.webp recibe un lento acercamiento en lugar de reproducirse.
3. Reglas
- Zona segura. Todo el texto se mantiene en x 140-940, y 288-1248. Las plantillas lo aplican a través de tres bandas:
top(y 288-600),middle(600-930),lower(930-1248). Solo eliges la banda. - Mantén el texto fuera del producto a menos que el resumen quiera que esté allí. Elige cada banda a partir de los fotogramas que extrajiste. Si cada banda cubre el producto en una toma, acorta la
durationdel texto o cambia la toma. - Líneas cortas. El texto se reduce para caber en 800 px, por lo que una línea larga se vuelve pequeña. Apunta a 22 caracteres latinos o 12 caracteres japoneses por línea. Envuelve una palabra en
*asteriscos*para colorearla con el acento. - Duraciones de clips.
start + duration * speedno debe superar el final del origen. La duración del video es la suma de las duraciones de los clips (BeforeAfterusaduration;Testimonialson las reseñas más el CTA). - Corta al ritmo cuando haya música: haz que las duraciones de los clips sumen las posiciones del ritmo.
- Fuentes. Funcionan latín, vietnamita (montserrat o anton, y todas las tarjetas de interfaz) y japonés. El coreano, tailandés, árabe y otros necesitan una fuente agregada en
reels/src/lib/kit.tsxprimero.
Pocos clips estáticos, muchos ángulos. Cuando el metraje es una o dos tomas fijas y el resumen es una edición rápida de múltiples ángulos (como un recorrido por la sala de exposición o un corte de tendencia de baile), usa BeatCutAd y reutiliza cada origen varias veces con un focus, zoom, tilt y push diferentes: abre con un plano general (zoom alrededor de 1.02), luego un detalle por ritmo (texto, personaje, nombre, manos, dobladillo), alterna el signo de tilt, mantén zoom en 1.7 o menos en fuentes de 768 px, y termina con un plano general. Usa transiciones cut; el push es la transición. Esto reencuadra el metraje; no puede crear un nuevo ángulo de cámara real.
Notas de las plantillas:
ChatStory,NotesList,NotificationStack: la interfaz se reproduce primero, luegoclips(la recompensa) aparecen y el CTA se muestra sobre ellos. Su duración es la parte de la interfaz más los clips. Deja fuerahook: la tarjeta llena la zona segura.backgroundson los medios atenuados detrás de la tarjeta.ChatStory: los mensajes se marcan por tiempo de lectura; estableceat(segundos) solo para forzar un ritmo. Un mensaje puede llevarimage(una foto del producto) en lugar de, o junto con,text.NotesList:check: truemarca una línea después de escribirse,highlight: truela resalta. Pon la línea del producto al final.SearchHook:pickes la sugerencia que se selecciona. Mantén la consulta por debajo de 34 caracteres.NotificationStack:icones un emoji,colorsu color de mosaico. Traducenowydatepor idioma.PolaroidDump: las fotos más cuadradas funcionan mejor.titleestá escrito a mano; las leyendas se mantienen por debajo de 20 caracteres. No hay clips: las fotos son el video.Ranking:itemsse reproducen en el orden escrito, así que escribe el rango más bajo primero y el rango 1 al final. Las etiquetas se mantienen por debajo de 20 caracteres.PollSticker: los valores depercentlos pones tú; usa números reales cuando el resumen los tenga y nunca presentes inventados como datos de encuesta.- Escribe el texto en estas interfaces como la gente escribe y publica: minúsculas está bien, líneas cortas, un emoji donde una persona usaría uno. Los nombres, mensajes y reseñas en ellas son ilustrativos a menos que el resumen proporcione los reales, así que no los atribuyas a personas reales.
UgcCaptions:wordsson{ text, start, end }en segundos en la línea de tiempo de salida. Obténlos de una transcripción con marcas de tiempo de palabras; no adivines tiempos.keepAudiopor defecto es verdadero. Una "palabra" puede ser una frase corta conwordsPerPage: 1.CommentReplyyOfferPromo: deja fuerahook. La burbuja o el titular ya usan la banda superior.OfferPromo: el CTA por defecto es la banda inferior.Testimonial: establece la banda del CTA enmiddle.ProductSlideshow:badgetoma\npara dos líneas; colócalo conbadgeBand.
4. Verificar, luego renderizar
Ejecuta estos desde reels/.
node render.mjs jobs/<trabajo>.json --still=1,6,12 --guides # zonas seguras dibujadas encima
node render.mjs jobs/<trabajo>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<trabajo>.json # cada idioma -> exports/<nombre>/
Las imágenes de control van a out/stills/ a la mitad del tamaño. Ábrelas y verifica: el texto está fuera del producto, nada se recorta, cada idioma cabe. Elige tiempos de imagen de control dentro del gancho, un subtítulo intermedio y el CTA. Los archivos nombrados _GUIDES son solo para verificar; nunca los entregues como resultado.
Renderiza los videos solo después de que las imágenes de control pasen. Si una imagen de control falla, corrige el trabajo y verifica de nuevo; después de tres rondas fallidas, repórtalo como un bloqueo. Un render imprime una línea por archivo con su ruta y duración. No publiques ni subas los videos a menos que el resumen lo indique.
Termina cada trabajo con un informe al solicitante. Cubre:
- las rutas de salida y duraciones;
- la plantilla y los valores predeterminados usados donde el resumen no especificó;
- la fuente de cada entrada, y si
public/tiene la única copia; - lo que eliminó la limpieza de la sección 6, y el espacio liberado.
5. Tamaño para Instagram
Los renders tienen aproximadamente 16 Mbps. Para comprimir uno para subir:
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. Medios y espacio en disco
Los medios llenan el disco. Las entradas (metraje, fotos, música copiados en public/<nombre>/) y las salidas (videos en exports/<nombre>/, aproximadamente 30 MB por idioma para 15 s) pertenecen a un trabajo, bajo el mismo nombre. Mantenlo así, porque la limpieza funciona por trabajo. Todo lo demás es temporal: imágenes de control de calidad en out/, y los paquetes temporales que Remotion escribe en la carpeta temporal del sistema operativo (cada uno contiene una copia completa de public/; render.mjs elimina los suyos, pero las ejecuciones fallidas y Studio dejan algunos atrás). El caché de webpack en node_modules/.cache crece a varios cientos de MB. node_modules/ (aproximadamente 1.3 GB, incluido el navegador headless) es un costo único. Volver a renderizar un trabajo sobrescribe sus archivos con los mismos nombres, por lo que los renders repetidos de un trabajo no se acumulan.
Si falta reels/clean.mjs (el espacio de trabajo se hizo desde un kit antiguo), copia clean.mjs y render.mjs de assets/reels-kit/ de esta habilidad a reels/ primero.
Ejecuta estos desde reels/, nunca mientras se ejecuta un render:
node clean.mjs --auto --keep=<n> # elimina los trabajos <n> más antiguos excepto los <n> más recientes
node clean.mjs --all # elimina todo
node clean.mjs --exports=<n> # igual, pero solo elimina los renders de salida
node clean.mjs --inputs=<n> # igual, pero solo elimina los medios de entrada y los archivos temporales de Remotion
--auto es "sí, confirma"; omítelo para una confirmación previa.
Los renders de trabajos individuales rehacen sus archivos de salida; los trabajos perdidos le cuestan al espacio de trabajo solo los archivos de entrada. El caché de webpack se elimina con rm -rf node_modules/.cache. Los archivos temporales de Remotion viven en la carpeta temporal del sistema, no en reels/; para limpiarlos, ejecuta node clean.mjs --temp.
7. Añadir una nueva plantilla
Cuando el resumen de un video no encaje en las 15 plantillas, crea una nueva:
- Dentro de
reels/src/, crea<NombrePlantilla>/conTemplate.tsx,schema.tsytypes.ts. Sigue el patrón de las plantillas existentes, en particular la composición
...