Communitygithub.com

freudianflips/breakout-launch-videos

웹사이트에서 브랜드 키트를 추출하고 검토하여 런칭 영상에 사용할 brand.json 파일을 생성하는 스킬입니다.

breakout-launch-videos란 무엇인가요?

이 스킬은 런칭 영상 제작을 위해 웹사이트에서 직접 브랜드 키트를 추출하고 검토하는 도구입니다. `brand-from-url.mjs` 스크립트를 실행하여 대상 사이트의 색상, 폰트, 로고, 이름, 태그라인, 카피, 제품 이미지 등 모든 브랜드 요소를 수집합니다. 추출된 데이터는 `brand.json` 파일로 저장되며, 런칭 영상 제작 도구인 `launch-film`이 이 파일을 읽어 영상의 시각적 스타일을 결정합니다. 사용자는 추출 후 자동 생성된 미리보기 시트(`preview.png`)를 검토하고, 잘못 추출된 값을 직접 수정할 수 있습니다. `evidence.json` 파일은 각 역할(role)이 어떻게 결정되었는지에 대한 상세 근거를 제공하여 수동 수정을 용이하게 합니다. 주요 기능으로는 로고 추출, 폰트 다운로드(Google Fonts 지원), 색상 역할 할당(ground, ink, accent, dark 등), 제품 이미지 수집 등이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용할 수 있으며, 브랜드별로 한 번 실행하면 충분하고 사이트 디자인이 변경될 때 다시 실행하면 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-brand

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

브랜드 출시

모든 출시 영화는 brand/brand.json에서 스타일을 읽어옵니다. 이 스킬은 독자의 웹사이트에서 해당 파일을 생성하고, 검증한 후 launch-film에 전달합니다. 브랜드당 한 번 실행하고, 사이트 스타일이 변경되면 다시 실행하세요.

1. 추출

npm install                                   # 최초 1회: puppeteer 및 해당 Chrome
node tools/brand-from-url.mjs https://your-site.com --out brand

1920x1080 해상도로 페이지를 열고, 쿠키 배너를 닫고, 지연 로딩 콘텐츠를 위해 한 번 스크롤한 후 다음 파일들을 작성합니다:

파일설명
brand.json영화에서 사용하는 역할(role)들입니다. 영화가 읽는 유일한 파일입니다.
evidence.json각 역할이 결정된 근거: 계산된 스타일, CSS 색상 변수, 픽셀 히스토그램, 버튼 및 링크 색상, 글꼴, 모든 로고 후보(점수 및 사유 포함).
logo.svg 또는 logo.png밝은 배경용 로고입니다. 어두운 배경용은 logo-on-dark.*, 아이콘만 분리 가능한 경우 mark.svg입니다.
fonts/페이지에서 실제로 로드한 디스플레이 및 본문 글꼴 파일입니다(페이지가 제공하지 않는 Google Fonts는 css2 API에서 가져옵니다).
screens/hero.png, screens/full.png첫 번째 뷰포트와 전체 페이지(최대 6000px)입니다.
images/가장 큰 콘텐츠 이미지(보통 제품 사진)입니다.
preview.png한 장의 시트: 밝은 배경 및 어두운 배경의 로고, 모든 색상 역할, 하이라이트가 있는 디스플레이 글꼴, 어두운 히어로 카드, 강조 버튼.

플래그: --no-fonts는 글꼴 파일을 건너뛰고, --max-images 0은 이미지를 건너뜁니다. 로컬 페이지도 작동합니다 (node tools/brand-from-url.mjs ./site/index.html). brand.json을 수동으로 편집한 후, node tools/brand-from-url.mjs --preview --out brand로 시트를 다시 렌더링하세요.

2. 검토 (절대 건너뛰지 마세요)

preview.png와 screens/hero.png를 나란히 읽으세요. 역할들은 휴리스틱(heuristics)입니다. 시트는 10초 안에 올바르게 선택되었는지 보여줍니다. 다음 순서로 확인하세요:

  1. 밝은 배경 및 어두운 배경의 로고. 둘 다 읽을 수 있어야 합니다. 어두운 배경에서 사라지는 로고는 밝은 버전이 필요합니다: 독자에게 파일을 요청하거나 logo-on-dark.svg 내부의 색상을 편집하세요.
  2. 강조(Accent). 사람들이 브랜드와 연관 짓는 색상(보통 메인 버튼)이어야 합니다. evidence.json에는 accent_candidates가 득표수와 함께 나열됩니다. 히어로 일러스트레이션 색상이나 상태 색상을 선택한 경우 올바른 16진수 코드로 교체하세요.
  3. 배경(Ground) 및 잉크(Ink). 성명(statement) 장면은 ground 위에 ink 타입으로 표시됩니다. 사이트의 느낌(따뜻한 오프화이트, 순백색, 색조 종이)과 일치해야 합니다.
  4. 어두움(Dark). 히어로 카드는 dark를 사용합니다. 브랜드 자체의 어두운 섹션처럼 보여야 하며, 임의의 거의 검은색이 아니어야 합니다. 사이트에 어두운 섹션이 없으면 도구가 강조 색상을 어둡게 합니다. 의도된 것처럼 보이는지 확인하세요.
  5. 글꼴. 디스플레이 글꼴이 시트의 히어로 단어에서 렌더링되어야 합니다. evidence.json의 fonts 아래에서 찾은 파일을 보여줍니다.
  6. 이름 및 태그라인. 태그라인은 잠금(lockup)에서 이름 아래에 위치합니다: 2~8 단어, 사이트 자체의 단어입니다.

잘못된 값을 brand.json에 직접 수정하고, 미리보기를 다시 렌더링한 후 독자에게 보여주고, 그때서야 "reviewed": true로 설정하세요. 수동으로 변경한 모든 내용을 답변에 한 줄로 기록하세요.

각 역할이 영화에서 하는 일

역할용도
ground모든 성명 장면, 제품 둘러보기의 바닥, 종료 잠금.
surface배경 위의 카드, 칩 및 창.
ink, ink_secondary밝은 배경 위의 히어로 단어 및 보조 단어.
accent드물게 사용: 장면당 1개 요소(버튼 누름, 스위치, 완료 상태). 요청사항에 강조 히어로 카드가 없는 한 절대 전체 배경으로 사용하지 마세요.
accent_ink강조 색상 위의 텍스트.
dark, dark_ink하드 컷 히어로 카드, 어두운 순간.
accent_on_dark어두운 카드의 핵심 단어(읽을 수 있을 때까지 밝아진 강조 색상; 단색 브랜드의 경우 dark_ink).
highlight줄당 1~2개의 핵심 단어 뒤에 있는 부드러운 마커. 절대 더 많이 사용하지 마세요.
success, danger체크 표시, 완료 상태, 드문 실패 단어.
fonts.display히어로 단어(사이트 h1의 두께 및 자간).
fonts.body보조 라인, UI 칩.
logo, name, tagline, domain컷의 이름 비트와 종료 잠금.
copy스크립트 단어. 영화는 사이트의 언어를 사용합니다. launch-story는 copy.h1, copy.subhead, copy.h2 및 copy.features에서 시작합니다.
images후보 제품 사진. 독자의 실제 제품 화면 또는 녹화본이 스크랩된 어떤 것보다 낫습니다.

대체(Fallback)

  • 로고를 찾을 수 없음. 도구가 사이트 아이콘으로 대체하고 그렇게 말합니다. 독자에게 SVG(가장 좋음) 또는 1000px 이상의 투명 PNG를 요청하세요. brand/에 넣고 logo.file이 이를 가리키도록 하세요.
  • 다크 모드 사이트. mode는 dark입니다. 페이지 배경색이 dark가 되고, ground와 ink는 밝은 성명 장면을 위해 파생됩니다. 브랜드가 어두운 성명 장면도 원하는 경우 ground와 dark(그리고 ink와 dark_ink)를 수동으로 바꾸세요.
  • 단색(Monochrome) 브랜드. 채도가 있는 색상이 득표를 얻지 못했으므로 accent는 메인 버튼 색상(종종 검은색)이고 highlight는 밝은 회색입니다. 독자에게 시그니처 색상이 있는지 물어보세요. 없으면 단색을 유지하고 타입과 모션이 영화를 이끌도록 하세요.
  • 웹 글꼴을 다운로드할 수 없음. 일부 파운드리(글꼴 제작사)는 직접 다운로드를 차단합니다. 글꼴을 로컬에 설치하거나(영화는 패밀리 이름으로 설치된 글꼴로 대체됨) Google Fonts에서 가장 가까운 오픈 글꼴을 선택해 brand/fonts/에 파일을 넣으세요.
  • 글꼴 라이선스. 웹 라이선스가 항상 비디오를 포함하지는 않습니다. 영화를 출시하기 전에 디스플레이 및 본문 글꼴이 비디오 또는 모션 사용에 대해 라이선스가 부여되었는지 확인하거나 오픈(OFL) 글꼴을 사용하세요.
  • 독자에게 브랜드 가이드가 있음. 독자의 가이드가 우선입니다. 해당 값을 brand.json에 수동으로 입력하고(동일한 키 유지), 로고 파일을 brand/에 넣고, 미리보기를 다시 렌더링한 후 검토됨으로 표시하세요.
  • 사이트가 헤드리스 브라우저를 차단함. 일반 브라우저에서 페이지를 저장하고(파일, 다른 이름으로 페이지 저장, 완료) 저장된 HTML 파일에 도구를 실행하세요.

인계(Hand-off)

launch-film은 빌드 시 brand/brand.json을 읽습니다. "reviewed": false로 빌드된 영화는 초안입니다. 보여줄 때 그렇게 말하세요.

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.

관련 스킬