Communitygithub.com

freudianflips/breakout-launch-videos

Construye el kit de marca que un video de lanzamiento utiliza a partir de un sitio web. Ejecuta tools/brand-from-url.mjs en el sitio del lector para extraer la marca (colores, tipografías, logotipo, nombre, eslogan, texto, imágenes de producto), luego revisa la hoja de previsualización con el lector y corrige cualquier rol incorrecto a mano. Úsalo para 'marca desde el sitio web', 'kit de marca', 'extraer marca', 'obtener nuestros colores y tipografías', 'usar nuestro logotipo' o antes del primer video de lanzamiento de una nueva marca.

¿Qué es breakout-launch-videos?

Esta habilidad automatiza la extracción de la identidad visual de una marca desde su sitio web para alimentar un pipeline de videos de lanzamiento. Lee el sitio del lector, extrae colores, tipografías, logotipos y textos, y genera un archivo brand.json que es la única fuente de estilo para el video. La habilidad está diseñada para agentes de IA como Claude Code que ejecutan scripts Node.js con Puppeteer, y funciona en cualquier sistema operativo con Node.js instalado. El proceso incluye revisión interactiva: el agente muestra una hoja de previsualización al usuario, permite editar manualmente los valores incorrectos (como el color de acento o la tipografía), y marca el archivo como revisado solo después de la aprobación. Soporta sitios con modo oscuro, marcas monocromáticas y guías de marca personalizadas, con fallbacks para logotipos faltantes o fuentes no descargables. Es ideal para equipos que producen múltiples videos de lanzamiento y necesitan mantener consistencia visual sin configuración manual repetitiva.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-brand

Preguntar en tu IA favorita

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

Documentación

Marca de lanzamiento

Cada video de lanzamiento lee su apariencia de brand/brand.json. Esta habilidad crea ese archivo a partir del sitio web del lector, lo verifica y lo entrega a launch-film. Ejecútalo una vez por marca, de nuevo cuando cambie la apariencia del sitio.

1. Extraer

npm install                                   # una vez: puppeteer y su Chrome
node tools/brand-from-url.mjs https://tu-sitio.com --out brand

Abre la página a 1920x1080, descarta los banners de cookies, se desplaza una vez para que se cargue el contenido lazy y escribe:

ArchivoQué contiene
brand.jsonLos roles que usa el video. El único archivo que lee el video.
evidence.jsonCómo se decidió cada rol: estilos calculados, variables CSS de color, histogramas de píxeles, colores de botones y enlaces, familias tipográficas, cada candidato a logotipo con su puntuación y razón.
logo.svg o logo.pngEl logotipo para fondos claros. logo-on-dark.* para fondos oscuros, mark.svg cuando se puede separar una marca de icono.
fonts/Los archivos de tipografía de visualización y cuerpo que la página realmente cargó (las fuentes de Google Fonts se obtienen de la API css2 cuando la página no las sirve).
screens/hero.png, screens/full.pngEl primer viewport y la página completa (limitada a 6000 px).
images/Las imágenes de contenido más grandes, generalmente fotos de productos.
preview.pngUna hoja: logotipo sobre fondo claro y sobre oscuro, cada rol de color, la tipografía de visualización con el resaltado, una tarjeta hero oscura, el botón de acento.

Banderas: --no-fonts omite los archivos de tipografía, --max-images 0 omite las imágenes. También funciona con una página local (node tools/brand-from-url.mjs ./site/index.html). Después de editar brand.json a mano, vuelve a renderizar la hoja con node tools/brand-from-url.mjs --preview --out brand.

2. Revisar (nunca saltar)

Lee preview.png y screens/hero.png lado a lado. Los roles son heurísticos; la hoja muestra en 10 segundos si se eligieron correctamente. Verifica, en este orden:

  1. Logotipo sobre fondo claro y sobre fondo oscuro. Ambos deben leerse. Un logotipo que desaparece sobre fondo oscuro necesita una versión clara: pídele al lector su archivo, o edita los colores dentro de logo-on-dark.svg.
  2. Acento. Debe ser el color que la gente asocia con la marca, generalmente el botón principal. evidence.json lista accent_candidates con sus votos. Intercambia el hex correcto cuando eligió un color de ilustración hero o un color de estado.
  3. Fondo y tinta. Las escenas de declaración se colocan sobre ground con tipo ink. Deben coincidir con la sensación del sitio (blanco roto cálido, blanco puro, un papel teñido).
  4. Oscuro. Las tarjetas hero usan dark. Debe parecerse a la sección oscura propia de la marca, no a un negro casi aleatorio. Si el sitio no tiene ninguna, la herramienta oscurece el acento; verifica que se vea intencionado.
  5. Tipografías. La tipografía de visualización debe renderizarse en las palabras hero de la hoja. evidence.json bajo fonts muestra qué archivos se encontraron.
  6. Nombre y eslogan. El eslogan se coloca debajo del nombre en el bloque: de 2 a 8 palabras, las propias palabras del sitio.

Corrige los valores incorrectos directamente en brand.json, vuelve a renderizar la previsualización, muéstrala al lector, y solo entonces establece "reviewed": true. Registra cualquier cosa que hayas cambiado a mano en una línea en tu respuesta.

Qué hace cada rol en el video

RolSe usa para
groundCada escena de declaración, el suelo del recorrido del producto, el bloque final.
surfaceTarjetas, chips y ventanas sobre el fondo.
ink, ink_secondaryPalabras hero y palabras de apoyo sobre fondos claros.
accentCon moderación: 1 elemento por escena (una pulsación de botón, el interruptor, el estado completado). Nunca un fondo completo a menos que el briefing pida una tarjeta hero de acento.
accent_inkTexto sobre el acento.
dark, dark_inkTarjetas hero de corte duro, los momentos oscuros.
accent_on_darkPalabras clave en tarjetas oscuras (el acento aclarado hasta que se lea; dark_ink para marcas monocromáticas).
highlightUn marcador suave detrás de 1 o 2 palabras clave por línea, nunca más.
success, dangerMarcas de verificación, estados completados, la rara palabra de error.
fonts.displayPalabras hero (peso y tracking del h1 del sitio).
fonts.bodyLíneas de apoyo, chips de UI.
logo, name, tagline, domainEl golpe de nombre en el corte y el bloque final.
copyPalabras para el guion. El video habla el idioma del sitio; launch-story comienza desde copy.h1, copy.subhead, copy.h2 y copy.features.
imagesFotos de producto candidatas. Las capturas de pantalla o grabaciones reales del producto del lector superan cualquier cosa extraída.

Fallbacks

  • No se encontró logotipo. La herramienta recurre al icono del sitio y lo indica. Pídele al lector un SVG (mejor) o un PNG transparente de al menos 1000 px de ancho; colócalo en brand/ y apunta logo.file a él.
  • Sitio en modo oscuro. mode es dark. El fondo de la página se convierte en dark, y ground e ink se derivan para escenas de declaración claras. Si la marca quiere también escenas de declaración oscuras, intercambia ground y dark (e ink y dark_ink) a mano.
  • Marca monocromática. Ningún color saturado ganó un voto, por lo que accent es el color del botón principal (a menudo negro) y highlight es un gris claro. Pregunta al lector si tiene un color distintivo; si no, mantenlo monocromático y deja que la tipografía y el movimiento lleven el video.
  • Tipografía web no descargable. Algunas fundiciones bloquean las descargas directas. Instala la tipografía localmente (el video recurre a las tipografías instaladas por nombre de familia) o elige la tipografía abierta más cercana de Google Fonts y coloca sus archivos en brand/fonts/.
  • Licencias de tipografía. Una licencia web no siempre cubre video. Antes de que el video se envíe, confirma que las tipografías de visualización y cuerpo estén licenciadas para uso en video o movimiento, o utiliza una tipografía abierta (OFL).
  • El lector tiene una guía de marca. Su guía prevalece. Ingresa sus valores en brand.json a mano (mantén las mismas claves), coloca los archivos de logotipo en brand/, vuelve a renderizar la previsualización y márcala como revisada.
  • El sitio bloquea navegadores headless. Guarda la página desde un navegador normal (Archivo, Guardar página como, completa) y ejecuta la herramienta en el archivo HTML guardado.

Entrega

launch-film lee brand/brand.json en tiempo de construcción. Un video construido con "reviewed": false es un borrador; díselo cuando lo muestres.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

freudianflips/breakout-launch-videos

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (measuring a render and studying a reference film). Review a rendered launch film like a demanding creative director, then drive the v1 to v2 loop. Measures rhythm, static runs, cuts against the beat grid, loudness, true peak and voice pace with a script, then applies an eye checklist for continuity at every cut, legibility, brand, real UI, claims and differentiation. Writes a gap list and a scorecard; nothing ships on numbers alone. Use on every render, and on a reference film to learn from it, for "review the video", "check the film", "what is wrong with this cut", "study this reference".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

freudianflips/breakout-launch-videos

Tool manual under launch-film (backgrounds, plates, Blender glass and 3D shots, shader layers). Build the world a launch film lives in, in your own brand, with generated background plates (cost-gated), Blender for real 3D glass objects and camera moves rendered as alpha layers, WebGL shader layers for atmosphere, and the layer order, depth of field and grade that keep UI legible over living backgrounds. Use when a storyboard needs backgrounds, 3D or atmosphere, for "background", "plate", "3D object", "glass", "Blender", "shader", "atmosphere"; motion of the UI itself is launch-motion.

Skills relacionados