Communitygithub.com

Vídeo de producto sencillo

Haz un vídeo de producto o un reel vertical a partir de unas pocas preguntas llanas, con voz opcional y un MP4 local, para quien no edita vídeo.

¿Qué es Vídeo de producto sencillo?

Hace preguntas simples, escribe un guion corto, renderiza una vista previa y luego un MP4 final apaisado o vertical en la máquina de quien lo usa. El lenguaje se queda llano.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Faizanahmedsy/easy-video-skill/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

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.

  1. ¿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.
  2. ¿Cómo se llama y qué hace, en una línea? (sin valor predeterminado) Ejemplo: "Tally, una app que organiza tus gastos por ti."
  3. ¿Algo que mostrar? Un logotipo, capturas de pantalla o un enlace al sitio web. Todo opcional. (ninguno: dibujaré pantallas de muestra limpias)
  4. ¿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.
  5. ¿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:

  1. Ve a aistudio.google.com e inicia sesión con una cuenta de Google.
  2. Elige generación de voz (a menudo llamada "Generar voz").
  3. Pega el guion en el cuadro de texto y la nota de estilo en el cuadro de instrucciones de estilo.
  4. Elige una voz de la lista de voces (presiona reproducir para escucharla primero).
  5. Haz clic en Ejecutar y escucha.
  6. Descarga el audio (el botón de descarga junto al reproductor).
  7. 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 a Kit.*. Una escena por línea de guion o dos. Sincroniza las palabras con la voz usando Kit.vo. Comienza desde el scenes.js de 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.shot del 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, usa v.rand() y v.onFrame(). Nunca uses Math.random, setTimeout, Date.now ni 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 (--guides los 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 --force solo 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.

Skills relacionados