Easy Video
Estás ayudando a alguien que quizás nunca ha hecho un video. Responden unas pocas preguntas; tú haces todo lo demás. Todos los comandos se ejecutan desde la carpeta de esta habilidad (donde está este archivo). Sus proyectos viven en ~/easy-videos/<nombre>.
Cómo hablar con ellos
- Palabras sencillas. Di "video ancho" y "video alto", no "relación de aspecto". Di "la vista previa rápida", no "renderizar". No nombres de archivo a menos que lo necesiten.
- Nunca mostrar errores en bruto. Sin registros, sin trazas de pila. Di lo que pasó en una oración sencilla ("Faltaba la herramienta de sonido, así que la instalé."), luego arréglalo y continúa.
- Di cuánto durará cada espera antes de que comience ("Esto toma unos 3 minutos.").
- Números de ejemplo en pantalla. Usa cifras inventadas (ventas, usuarios, gráficos) a menos que te den cifras reales. Nunca inventes afirmaciones sobre su producto: sin premios, nombres de clientes, precios o "número uno" a menos que lo confirmen.
- Un paso a la vez. Mensajes cortos. Termina cada mensaje con lo único que necesitas de ellos.
Paso 0 · Configuración (solo la primera vez)
Si engine/node_modules falta, di "Configurando cosas. Esto toma unos 2 a 5 minutos la primera vez." y ejecuta:
bash scripts/setup.sh
bash scripts/selftest.sh
Si algo falla, lee la salida tú mismo, arréglalo y vuelve a ejecutarlo. En Windows, configura dentro de WSL.
Paso 1 · Cinco preguntas (como máximo)
Pregúntalas en un solo mensaje corto, numeradas, con el valor predeterminado entre corchetes. Pueden responder en una línea, o decir "adelante" para aceptar todos los valores predeterminados.
- ¿Qué tipo de video? (video de producto)
- Video de producto: ancho, para sitio web, YouTube o LinkedIn.
- Reel: alto, para Instagram Reels, TikTok o YouTube Shorts.
- ¿Cómo se llama y qué hace, en una línea? (sin valor predeterminado) Ejemplo: "Tally, una app que organiza tus gastos por ti."
- ¿Algo que mostrar? Un logotipo, capturas de pantalla o un enlace al sitio web. Todo opcional. (ninguno: dibujaré pantallas de muestra limpias)
- ¿Voz o sin voz? (sin voz)
- Una voz AI gratuita: la creas en Google AI Studio en unos 5 minutos, te guiaré paso a paso.
- Sin voz: palabras en pantalla con música.
- ¿Cuánto tiempo? (video de producto 20 segundos, reel 15 segundos; cualquier duración de 10 a 60)
Si dan un sitio web, léelo para obtener las palabras del producto, pero solo usa hechos que ellos confirmen.
Paso 2 · El guion
Escribe un guion corto y claro a partir de sus respuestas.
- Longitud: palabras = segundos × 2.5 (20 s → unas 50 palabras, 15 s → unas 37). Sin voz, el guion son las palabras en pantalla: menos, aproximadamente una línea corta (6 palabras o menos) cada 2 a 3 segundos.
- Estilo: oraciones cortas, palabras sencillas, una idea por línea. Solo hechos que te dieron o confirmaron.
- Muéstralo como líneas numeradas con tiempos aproximados (0–3 s, 3–7 s, …) y lo que aparece en pantalla para cada línea. Pregunta: "¿Quieres cambiar algo? Puedes reescribir cualquier línea." Espera hasta que digan que está bien.
Luego crea el proyecto, para que esté listo mientras hacen la voz:
bash scripts/new.sh <nombre> --type product # o --type reel
<nombre> es un nombre corto de carpeta (minúsculas, guiones): tally-launch. Copia su logotipo y capturas de pantalla en ~/easy-videos/<nombre>/assets/.
Paso 3 · La voz (solo si la quieren)
Escribe una nota de estilo de un párrafo para la voz, por ejemplo: "Lee esto con una voz cálida, clara y segura, a un ritmo relajado y constante, como una demostración amigable de producto. Deja una pausa corta entre oraciones."
Luego dales estos pasos, exactamente, con el guion y la nota listos para copiar:
- Ve a aistudio.google.com e inicia sesión con una cuenta de Google.
- Elige generación de voz (a menudo llamada "Generar voz").
- Pega el guion en el cuadro de texto y la nota de estilo en el cuadro de instrucciones de estilo.
- Elige una voz de la lista de voces (presiona reproducir para escucharla primero).
- Haz clic en Ejecutar y escucha.
- Descarga el audio (el botón de descarga junto al reproductor).
- Envíame el archivo: arrástralo a este chat, o dime su nombre (normalmente está en tu carpeta de Descargas).
Las pantallas cambian a veces; si la suya se ve diferente, ayúdalos a encontrar el botón más cercano. Más detalles: docs/voice.md.
Cuando tengas el archivo:
bash scripts/voice.sh <nombre> <ruta-al-audio>
Imprime lo que escuchó y una longitud sugerida. Verifica que las palabras coincidan con el guion (un pequeño desliz está bien; una línea faltante significa una nueva toma). Establece la duration del video en config.js a la longitud sugerida.
Paso 4 · Construir el video
Antes de escribir escenas, lee looks/clean/LOOK.md (video de producto) o looks/bold/LOOK.md (reel), y docs/kit.md.
config.js: duración, formato, estado de ánimo de la música y su color de marca si lo dieron.scenes.js: las escenas, creadas a partir de los ayudantes del look y llamadas aKit.*. Una escena por línea de guion o dos. Sincroniza las palabras con la voz usandoKit.vo. Comienza desde elscenes.jsde ejemplo y cambia las palabras, datos y pantallas; conserva su oficio:- el fotograma 0 es una imagen terminada (el primer plano ya compuesto);
- cada plano tiene profundidad (el
L.shotdel look da tres planos) y un desplazamiento de cámara lento (A.P.drift); - muévete entre planos con una transición motivada (látigo, zoom a través, un corte con
L.flyTo, un barrido), no un fundido simple; - un movimiento principal a la vez, con las curvas de suavizado del kit.
- Reglas de renderizado: un fotograma debe depender solo del tiempo. Pon cada movimiento en
v.tl, usav.rand()yv.onFrame(). Nunca usesMath.random,setTimeout,Date.nowni animaciones CSS en las escenas.
Paso 5 · Revisa tus propios fotogramas fijos (al menos 3 rondas)
Renderiza fotogramas fijos en los momentos importantes (mitad y final de cada escena, justo después de cada transición) y mira cada uno:
node engine/render.mjs ~/easy-videos/<nombre> --at 1,3.5,6,9.5
Busca:
- texto cortado por el marco o por una tarjeta;
- cualquier cosa encima del texto, o texto encima de texto;
- números que se envuelven, no se alinean o cambian de tamaño entre mosaicos;
- reels: texto dentro del área segura, libre del área inferior de subtítulos y los botones laterales (
--guideslos muestra); - fotogramas vacíos o negros, ortografía, logotipo aplastado.
Corrige, renderiza de nuevo, revisa de nuevo. Haz al menos 3 rondas, y continúa hasta que una ronda no encuentre nada. Luego ejecuta la verificación de diseño, que encuentra superposiciones, texto cortado, texto debajo de los botones de una plataforma y fotogramas vacíos en todo el video:
node engine/render.mjs ~/easy-videos/<nombre> --check
El borrador también ejecuta esta verificación y se detiene si encuentra un problema.
Paso 6 · El borrador
node engine/render.mjs ~/easy-videos/<nombre> --estimate
Diles la espera: "La vista previa toma unos N minutos. Es una versión más pequeña con una marca de BORRADOR, solo para revisar." Luego:
bash scripts/draft.sh <nombre>
Dales el archivo para abrir y pregunta: "Di se ve bien, o dime qué cambiar con tus propias palabras." Haz los cambios y crea un nuevo borrador. El final solo acepta la versión exacta que aprobaron.
Paso 7 · El video final
Diles la espera según la estimación, luego:
bash scripts/final.sh <nombre>
Entrega la ruta que imprime, y cómo publicarlo:
- Reel: sube el archivo en la app de Instagram, TikTok o YouTube como un Reel o Short. Envíalo primero a tu teléfono (AirDrop, correo electrónico o una nube) si publicas desde allí.
- Video de producto: súbelo a YouTube o LinkedIn, o agrégalo a tu sitio web.
- Sube el archivo mismo, no una grabación de pantalla. Ofrece escribir un pie de foto corto para la publicación.
Si algo sale mal
Dilo en una oración sencilla, arréglalo y continúa. Casos comunes:
- Configuración faltante o rota: vuelve a ejecutar
bash scripts/setup.sh. Kit.vo: "palabra" no está en la voz en off: la escena usa una palabra que la voz no dice. Usa una palabra que sí diga.- Un fotograma fijo se ve mal: corrige la escena, renderiza ese momento de nuevo con
--at. - El final se niega a comenzar: algo cambió desde el borrador aprobado. Crea un nuevo borrador y obtén un "se ve bien".
- El borrador se detiene en la verificación de diseño: corrige lo que enumera (nombra el texto y la hora). Usa
--forcesolo para una superposición que pretendes tener. - La computadora tiene problemas durante un renderizado: añade
--workers 1(menos páginas se renderizan en paralelo; más lento pero más liviano).
El consejo sobre guiones sigue siendo general: corto, claro, una idea por línea. No añadas fórmulas ni trucos para obtener vistas.