Communitygithub.com

freudianflips/breakout-launch-videos

Construire la charte graphique qu'un film de lancement utilise à partir d'un site web. Exécute tools/brand-from-url.mjs sur le site du lecteur pour extraire les éléments de marque (couleurs, polices, logo, nom, slogan, textes, images du produit), puis examine avec le lecteur la feuille d'aperçu et corrige manuellement les rôles erronés.

Qu'est-ce que breakout-launch-videos ?

Cette compétence crée automatiquement le fichier `brand/brand.json` qu'un film de lancement (`launch-film`) utilise pour son apparence, en extrayant les éléments de marque depuis le site web du lecteur. Elle est utile pour les développeurs ou créateurs qui souhaitent produire des vidéos promotionnelles cohérentes avec l'identité visuelle de leur marque, sans conception manuelle. La compétence prend en charge les navigateurs headless via Puppeteer, extrait les couleurs (via heuristiques comme les histogrammes de pixels), les polices (y compris Google Fonts), les logos, et génère une feuille d'aperçu `preview.png`. Le lecteur examine ensuite cette feuille avec l'IA pour corriger les erreurs éventuelles, et une fois validé, le fichier est utilisé par `launch-film` pour produire la vidéo. Elle fonctionne sur tout site web public, avec des options pour ignorer les polices ou images.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Marque de lancement

Chaque film de lancement utilise le fichier brand/brand.json pour son apparence. Cette compétence crée ce fichier à partir du site web du lecteur, le vérifie et le transmet à launch-film. Exécutez-la une fois par marque, et de nouveau lorsque l'apparence du site change.

1. Extraction

npm install                                   # une fois : puppeteer et son Chrome
node tools/brand-from-url.mjs https://votre-site.com --out brand

Elle ouvre la page en 1920×1080, ferme les bannières de cookies, défile une fois pour charger le contenu différé, et écrit :

FichierContenu
brand.jsonLes rôles utilisés par le film. Le seul fichier que le film lit.
evidence.jsonCe qui a permis de décider chaque rôle : styles calculés, variables CSS de couleur, histogrammes de pixels, couleurs des boutons et liens, polices, chaque candidat logo avec son score et sa raison.
logo.svg ou logo.pngLe logo pour les fonds clairs. logo-on-dark.* pour les fonds sombres, mark.svg lorsqu'un icône seul peut être séparé.
fonts/Les fichiers de police d'affichage et de corps que la page a effectivement chargés (les polices Google Fonts sont récupérées depuis l'API css2 si la page ne les sert pas).
screens/hero.png, screens/full.pngLe premier viewport et la page entière (limitée à 6000 px).
images/Les plus grandes images de contenu, généralement des photos de produits.
preview.pngUne feuille : logo sur fond clair et sur fond sombre, chaque rôle de couleur, la police d'affichage avec le surlignage, une carte héros sombre, le bouton d'accentuation.

Drapeaux : --no-fonts ignore les fichiers de police, --max-images 0 ignore les images. Une page locale fonctionne aussi (node tools/brand-from-url.mjs ./site/index.html). Après modification manuelle de brand.json, ré-affichez la feuille avec node tools/brand-from-url.mjs --preview --out brand.

2. Révision (ne jamais sauter)

Lisez preview.png et screens/hero.png côte à côte. Les rôles sont heuristiques ; la feuille montre en 10 secondes s'ils ont été bien choisis. Vérifiez, dans cet ordre :

  1. Logo sur fond clair et sur fond sombre. Les deux doivent être lisibles. Un logo qui disparaît sur fond sombre nécessite une version claire : demandez au lecteur son fichier, ou modifiez les couleurs dans logo-on-dark.svg.
  2. Accentuation. Ce doit être la couleur que les gens associent à la marque, généralement le bouton principal. evidence.json liste accent_candidates avec leurs votes. Remplacez le bon hex si l'outil a choisi une couleur d'illustration héros ou une couleur de statut.
  3. Fond et encre. Les scènes de déclaration utilisent ground avec ink comme type. Ils doivent correspondre à l'ambiance du site (blanc cassé chaud, blanc pur, papier teinté).
  4. Sombre. Les cartes héros utilisent dark. Il doit ressembler à la section sombre de la marque, pas à un noir aléatoire. Si le site n'en a pas, l'outil assombrit l'accentuation ; vérifiez que le résultat semble intentionnel.
  5. Polices. La police d'affichage doit être rendue dans les mots héros de la feuille. evidence.json sous fonts montre quels fichiers ont été trouvés.
  6. Nom et slogan. Le slogan se trouve sous le nom dans le bloc : 2 à 8 mots, les propres mots du site.

Corrigez manuellement les valeurs erronées dans brand.json, régénérez la feuille d'aperçu, montrez-la au lecteur, puis mettez "reviewed": true. Enregistrez dans votre réponse tout ce que vous avez modifié manuellement en une ligne.

Rôle de chaque rôle dans le film

RôleUtilisé pour
groundChaque scène de déclaration, le sol de la présentation du produit, le bloc de fin.
surfaceCartes, puces et fenêtres sur le fond.
ink, ink_secondaryMots héros et mots secondaires sur fonds clairs.
accentAvec parcimonie : 1 élément par scène (un appui sur bouton, l'interrupteur, l'état terminé). Jamais un fond entier sauf si le brief demande une carte héros accentuée.
accent_inkTexte sur l'accentuation.
dark, dark_inkCartes héros à coupe franche, les moments sombres.
accent_on_darkMots clés sur cartes sombres (l'accentuation éclaircie jusqu'à être lisible ; dark_ink pour les marques monochromes).
highlightUn marqueur doux derrière 1 ou 2 mots clés par ligne, jamais plus.
success, dangerCoches, états terminés, le rare mot d'erreur.
fonts.displayMots héros (poids et crénage d'après le h1 du site).
fonts.bodyLignes secondaires, puces d'interface utilisateur.
logo, name, tagline, domainLe temps du nom sur la coupe et le bloc de fin.
copyMots pour le script. Le film parle la langue du site ; launch-story commence par copy.h1, copy.subhead, copy.h2 et copy.features.
imagesPhotos de produits candidates. Les vraies captures d'écran ou enregistrements du lecteur surpassent tout ce qui est récupéré automatiquement.

Solutions de repli

  • Aucun logo trouvé. L'outil utilise l'icône du site et le signale. Demandez au lecteur un SVG (meilleur) ou un PNG transparent d'au moins 1000 px de large ; placez-le dans brand/ et pointez logo.file vers lui.
  • Site en mode sombre. mode est dark. L'arrière-plan de la page devient dark, et ground et ink sont dérivés pour les scènes de déclaration claires. Si la marque souhaite aussi des scènes de déclaration sombres, échangez manuellement ground et dark (ainsi que ink et dark_ink).
  • Marque monochrome. Aucune couleur saturée n'a gagné un vote, donc accent est la couleur du bouton principal (souvent noir) et highlight est un gris clair. Demandez au lecteur s'il a une couleur signature ; sinon, gardez le monochrome et laissez le type et le mouvement porter le film.
  • Police web non téléchargeable. Certaines fonderies bloquent les téléchargements directs. Installez la police localement (le film utilise les polices installées par nom de famille) ou choisissez la police ouverte la plus proche parmi Google Fonts et placez ses fichiers dans brand/fonts/.
  • Licence de police. Une licence web ne couvre pas toujours la vidéo. Avant la sortie du film, confirmez que les polices d'affichage et de corps sont sous licence pour usage vidéo ou cinéma, ou utilisez une police ouverte (OFL).
  • Le lecteur possède un guide de marque. Son guide prévaut. Saisissez ses valeurs dans brand.json manuellement (conservez les mêmes clés), placez les fichiers de logo dans brand/, régénérez la feuille d'aperçu et marquez-la comme révisée.
  • Le site bloque les navigateurs headless. Enregistrez la page depuis un navigateur normal (Fichier, Enregistrer la page sous, complète) et exécutez l'outil sur le fichier HTML enregistré.

Remise

launch-film lit brand/brand.json au moment de la construction. Un film construit avec "reviewed": false est un brouillon ; mentionnez-le lorsque vous le montrez.

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 associés