Communitygithub.com

TurkiHassan/period-launch-video

Crea un video de lanzamiento de producto cuadrado (1440², 60fps) de 24 segundos en bucle, donde toda la historia ocurre *dentro del punto de la marca*. Renderizado con Playwright, con desenfoque de movimiento y sincronización con el ritmo de la canción.

¿Qué es period-launch-video?

Este skill genera un video promocional de 24 segundos en formato cuadrado (1440x1440 píxeles, 60 fotogramas por segundo) que se reproduce en bucle y donde la narrativa completa del producto transcurre dentro del punto de su logotipo. Está diseñado para crear presentaciones de lanzamiento altamente pulidas, con efectos visuales como paneles de vidrio, transiciones suaves y sincronización precisa con el ritmo de una canción. Es compatible con plataformas como Playwright para el renderizado y puede integrarse con herramientas de generación de imágenes como Higgsfield MCP, Codex (a través de ChatGPT) o Gemini. El flujo de trabajo incluye la configuración inicial del proyecto, la recopilación de activos (íconos, canciones, copias), la generación de cuatro imágenes base (día, noche, amanecer y exterior), la validación de alineación y color, y la renderización final con verificación de bucle limpio y niveles de audio profesionales (-14 LUFS). También admite adaptaciones para productos con escritura de izquierda a derecha (LTR), como los que usan marcas en inglés.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

Preguntar en tu IA favorita

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

Documentación

Video de lanzamiento en el punto

Un bucle de 24 segundos en el que todo el trabajo del producto se desarrolla dentro del punto de su marca. Todo se envía en template/: el renderizador (index.html, todo el contenido en config.js), los scripts de renderizado, escaneo y audio, las fuentes, el puntero real de macOS y los efectos de sonido medidos con pico. Tu trabajo consiste principalmente en elegir contenido y fotos, y luego ejecutar el pipeline. Lee references/craft.md una vez antes de cambiar cualquier movimiento. Contiene la dirección, el mapa de ritmos y los errores ya resueltos.

Flujo de trabajo

1 · Configuración

~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>

Coloca la salida dentro del proyecto del usuario. Usa una carpeta ignorada por git como brag-output/ si existe. El script también copia el puntero real de macOS desde esta Mac (make_pointers.py, no redistribuido) e instala Playwright. Para igualar el aspecto original, coloca los archivos woff2 de Thmanyah Sans (thmanyah-sans-{400,500,700}.woff2) en assets/fonts/. Sin ellos, se usa IBM Plex Sans Arabic.

2 · Recopilar entradas del proyecto (pregunta solo por lo que falte)

  • Identidad a partir de la versión publicada. Usa las capturas de pantalla de la App Store, el catálogo de activos de iOS (icono, colores) y los datos de muestra y el texto de la propia aplicación. Ignora activos web desactualizados. Si no puedes saber qué versión está activa, pregunta. Esta fue la principal corrección desde la primera ejecución.
  • Icono: copia el icono cuadrado de la aplicación a assets/img/icon.png. La plantilla aplica la máscara de esquinas de iOS por sí misma.
  • Canción: usa la pista existente del proyecto si la hay; de lo contrario, pregunta. Ejecuta python3 find_hit.py assets/music/song.mp3 y establece config.song.hit (≈ el hit informado − 0.04) y bpm. enterAt (por defecto 3.10) es el momento en que cae el hit, en la primera píldora. Mantén enterAt + 20 beats alrededor de 13.5 s para que Resultados caiga en el beat 20.
  • Texto: completa config.js: nombre (una palabra, se convierte en la marca negra más el punto), eslogan, dos líneas de apertura, la píldora de solicitud, el trabajo, las etiquetas de buscar/escribir/noche, 3 resultados, notificaciones, 5 filas de biblioteca, el valor del gráfico y la llamada a la acción (CTA). Mantén cada número coherente entre los tiempos. Usa dígitos occidentales. Mantén el JSON estricto, porque audio.py lo analiza.
  • Verificación de honestidad: si la historia implica algo que el producto no hace (trabajo por lotes nocturno, por ejemplo), dilo antes de renderizar y ofrece una redacción neutral.

3 · Fotos (cuatro placas)

Sigue references/image-prompts.md. Elige la ruta según lo disponible:

  1. Higgsfield MCP con créditos. Día primero, luego noche y amanecer como ediciones del trabajo del día, más exterior. Verifica el costo primero.
  2. Codex local (which codex). scripts/codex_image.sh usa el image_gen integrado de Codex con la suscripción ChatGPT del usuario.
  3. Sin créditos y sin Codex. Proporciona al usuario los cuatro prompts completados (Gemini para las ediciones) y espera los archivos.

Luego:

python3 check_align.py      # noche/amanecer deben ser desplazamiento (0,0) vs día
python3 grade_plates.py     # → assets/img/*.jpg + copias borrosas; vista previa out/plates.jpg

4 · Mapa de ritmos + seis fotogramas → aprobación antes de renderizar

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # apertura, buscar, escribir, resultados, teléfono, salida
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

Revisa cada fotograma tú mismo primero: el texto encaja, nada está recortado, el vidrio es legible sobre la placa. Luego muestra al usuario la hoja (SendUserFile) y una tabla de mapa de ritmos construida a partir de T en index.html. Renderiza solo después de su aprobación.

5 · Renderizar, verificar, entregar

./build.sh out/<slug>-launch.mp4     # 4 trabajadores de renderizado → scan.py + scan_local.py → línea de tiempo + audio → H.264/AAC
  • scan.py debe informar una diferencia de costura de aproximadamente 0 (un bucle limpio) y sin picos ni escalones.
  • Los hits de scan_local.py están bien cuando son contadores o escritura. Cualquier otra cosa es un estallido real: encuentra qué transición lo causó y arréglalo. Luego vuelve a renderizar solo esos fotogramas con node render.mjs a b y recodifica con la línea de ffmpeg de build.sh.
  • Extrae un fotograma al final de cada contador y confirma que muestra el número final exacto.
  • Informa las especificaciones (1440², 60fps, 1440 fotogramas, 24.0 s, LUFS, pico), cualquier bandera de honestidad abierta y la ruta del archivo.

Adaptación más allá de los valores predeterminados

  • Re-temporización: edita T en index.html (mantén deslizamientos de 0.8 s), luego vuelve a ejecutar node timeline.mjs && python3 audio.py.
  • Filas de biblioteca están fijadas en 5 por el diseño. El eje del gráfico tiene 3 etiquetas (inicio, medio, fin).
  • Productos LTR (marca en inglés): la plantilla está diseñada RTL. El punto se sitúa en el extremo izquierdo, las filas y píldoras se anclan a la derecha, y los escaneos y gráficos se ejecutan de derecha a izquierda. Para LTR, refleja esos anclajes (align, los bordes R/L, scanX, cpt) y coloca el icono a la izquierda. Reserva tiempo para esto y verifica cada fotograma.

Referencias (procesadas, no para distribuir)

  • references/craft.md: dirección artística, mapa de ritmos, errores resueltos.
  • references/image-prompts.md: prompts para la generación de las cuatro placas.
  • references/consulted-runs.md: ejecuciones anteriores (extractos de historial de Claude) que pueden informar la copia, el diseño o el ritmo.

Skills relacionados