Communitygithub.com

freudianflips/breakout-launch-videos

회사 브랜드에 맞춰 제품 런칭 영상을 제작하거나 수정합니다. 훅(컷 이전의 스토리)과 바디(제품명, 영웅 단어, 제품 클로즈업, 로고)로 구성된 영상을 HyperFrames 기반으로 제작합니다.

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

이 스킬은 `brand/brand.json`과 `film/film.json`을 기반으로 브랜드 아이덴티티에 맞춘 제품 런칭 영상(launch film)을 제작하고 수정하는 AI 에이전트용 도구입니다. 영상은 '훅(hook)'과 '바디(body)'로 구성되며, 훅은 컷 이전의 스토리(4~18초)이고 바디는 브랜드명, 영웅 단어, 제품 클로즈업, 로고로 구성된 공유 템플릿입니다. 새로운 훅을 추가하거나 바디를 변경하는 전체 워크플로우(빌드, 렌더링, 믹싱)를 지원하며, 브랜드 키트, 음성, 음악, 리뷰 등의 하위 스킬과 연동됩니다. Apple 및 Lovable 스타일의 영상 문법을 따르며, -14 LUFS의 오디오 레벨, 16:9 해상도 등 엄격한 기술 규격을 준수합니다. Cursor, Claude Code 등 AI 코딩 에이전트에서 사용 가능하며, 브랜드 일관성과 품질 관리를 자동화합니다.

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

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

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

문서

런칭 영상(Launch film)

여기의 모든 런칭 영상은 훅과 바디로 구성됩니다. 훅은 컷 이전의 스토리(4~18초, 어떤 아이디어든 가능)입니다. 음악이 드롭되는 지점에서 브랜드로 컷되며, 바디는 제품명을 소개하고 비트에 맞춰 클로즈업으로 제품을 보여주며, 기능을 하나의 아이디어로 압축하고 마지막에 로고로 조용히 마무리됩니다. 바디는 모든 훅이 공유하는 하나의 템플릿이므로, 새 훅은 폴더 1개와 JSON 파일 1개만 있으면 되고 바디를 변경하면 모든 영상에 반영됩니다.

작업 프로젝트는 film/입니다. film/film.json은 바디(스크립트 라인과 비트)이고, film/hooks/<name>/hook.json은 각 훅이며, brand/brand.json은 브랜드 정보입니다.

시작하기

  1. 브랜드. brand/brand.json을 읽습니다. 파일이 없거나, 여전히 예제 브랜드이거나, "reviewed": false인 경우 먼저 launch-brand 스킬을 실행합니다(웹사이트를 브랜드 키트와 미리보기 시트로 변환). 영상의 모든 색상, 폰트, 로고는 절대 기억에 의존하지 않고 이 파일에서 가져옵니다.
  2. 브랜드 코어. references/brand-core.md를 읽습니다: 각 브랜드 역할이 영상에 어떻게 매핑되는지와 브랜드 정보가 부족할 때의 기본값을 설명합니다.
  3. 스토리. 새 영상은 launch-story에서 시작합니다(브리프, 스파인, 스크립트, 비트 시트). 기존 바디에 새 훅을 추가하는 경우 아래 "새 훅 만들기"부터 시작할 수 있습니다.
  4. 교훈. 첫 프레임을 작업하기 전에 references/lessons.md를 훑어봅니다. 각 라인은 한 번의 라운드 비용이 들었습니다.

핵심 (유지할 것)

  • 형식: 16:9, 1920x1080, 30fps, 바디 포함 약 30~60초. 영상은 HyperFrames에서 무음으로 렌더링되고, 사운드는 키트 파이프라인으로 제작되어 먹싱되며, 마스터는 -14 LUFS 통합 및 -1 dBTP입니다.
  • 룩: brand/brand.json에서 가져옵니다. 브랜드 ground에 명시적 장면, ink에 헤드라인(1~2개의 키워드는 highlight 아래), dark에 다크 히어로 카드, 배경과 장면당 하나의 중요한 요소에 accent(긴 글자에는 사용 금지). fonts.display의 디스플레이 폰트. 웹사이트에 표시되는 그대로의 로고.
  • 문법: Apple과 Lovable 런칭 문법. 풀프레임 히어로 단어가 보이스에 맞춰 하드 컷(첫 단어는 2.4배 크기에 블러에서 스냅, 나머지는 1.3배에서 스텝 인), 배경은 하드 컷으로 변경, 한 오브젝트가 다음 오브젝트로 전환(다이빙, 붕괴, 모핑), 실제 제품 UI를 클로즈업으로 빠르게 보여주되 숨 쉴 공간을 주고, 조용한 마지막 홀드.
  • 보이스: 전체 영화에 한 명의 내레이터. 모든 새 라인은 그 목소리로 녹음됩니다. 타입은 강제 정렬(forced alignment)에 의해 타이밍이 맞춰진 내레이터의 단어에 맞춰 배치됩니다.
  • 음악: 1개의 트랙으로, 훅 길이에 관계없이 킥(드롭)이 컷 지점에 떨어지도록 배치되며, 마디 그리드로 루프되어 끝까지 재생되고 로고 아래에서 페이드 아웃됩니다. 사운드 효과는 합성된 단조(forged) 또는 생성된 키트 중 하나의 팔레트에서 가져옵니다.
  • 푸티지: 생성된 푸티지 또는 직접 제공한 푸티지. 가상의 인물, 유명인이나 닮은꼴 금지, 실제 영화나 배우 금지, 통합 이름을 언급하는 경우 외에는 타사 브랜드 금지. 프롬프트는 출처 증명으로 푸티지와 함께 보관(docs/rights.md).
  • 단어: 제품 자체의 단어. 메시지 단어는 실제 웹사이트(brand.json의 copy)에서 가져오며, 소유자의 카피를 그대로 사용합니다. 모든 숫자는 사실이고 증명 가능해야 합니다.

열려 있는 것

그 외의 모든 것은 영화마다 선택 사항입니다: 훅의 스토리, 룩, 길이, 자체 사운드, 제품명 언급 여부. 아이디어에 가장 잘 맞는 것을 선택하고 모든 것을 만들기 전에 룩을 먼저 보여줍니다. 바디는 요청받았을 때만 변경하고, 그때는 템플릿이나 film.json에서 변경하며, 절대 하나의 훅에서 변경하지 않습니다.

새 훅 만들기

  1. 아이디어와 카피. 소유자의 단어로 아이디어를 작성합니다. 그들의 라인을 그대로 유지합니다.
  2. 먼저 룩을 보여줍니다. 유료 영상 작업 전에 3~5개의 키프레임 또는 스토리보드 페이지를 준비합니다. 프레임은 빠르게 평가되며, 잘못된 룩으로 전체를 빌드하면 하루를 낭비합니다.
  3. 영상. 타입 전용(무료: "video": null + ground), 직접 촬영한 푸티지, 또는 생성된 푸티지(references/generation.md). 모든 영상 작업의 크레딧 비용을 명시하고 승인을 기다립니다. 생성된 얼굴이 유명인과 닮았는지 확인합니다.
  4. 훅 폴더. film/hooks/<name>/에 영상, 보이스 라인, hook.json(스키마는 references/hooks.md)을 넣습니다. 약 4초보다 긴 훅은 자체 음악 배경을 가져오거나 드롭 전까지 무음으로 재생됩니다.
  5. 빌드, 렌더링, 믹싱. film/에서 ./render.sh <name> 실행(빌드, HyperFrames가 index-<name>.html에서 렌더링, 오디오). 마스터는 film/renders/에 저장됩니다.
  6. 확인(아래 참조) 후, 갭 목록과 함께 보여주고 노트에 평가 결과를 기록합니다.

바디 변경하기

바디의 비트, 해당 필드 및 이를 그리는 코드는 references/body.md에 있습니다. 변경 시:

  1. film/film.json(라인, 비트, 단어, 포커스 직사각형) 또는 템플릿 film/templates/body.html을 변경하고, 생성된 film/compositions/*.html은 절대 변경하지 않습니다.
  2. 새 라인 또는 변경된 라인: 내레이터의 목소리로 녹음하고, 모든 단어가 재정렬되도록 보이스 준비를 다시 실행(skills/launch-voice/scripts/prep_lines.py)하면 큐가 단어를 따릅니다.
  3. 변경된 초를 스냅샷으로 찍고 렌더링 전에 확인합니다(references/hyperframes-notes.md).
  4. ./render.sh는 모든 훅을 다시 빌드, 렌더링 및 믹싱합니다(영화당 몇 분 소요).

공개 전 확인 사항

  • 단어: whisper가 모든 라인을 정확하게 읽는지 확인합니다(whisper-cli -m models/ggml-small.en.bin 이상; 기본 모델은 제품명을 잘못 인식함).
  • 음량: -14.0 LUFS 통합, 트루 피크 -1.0 dBTP 이하(ffmpeg -af ebur128=peak=true). skills/launch-review/scripts/review.py가 둘 다 측정합니다.
  • 싱크: 모든 히어로 단어와 주요 순간이 말하는 단어와 약 0.1초 이내로 일치해야 합니다.
  • 영상: 모든 새 비트의 콘택트 시트(review.py가 filmstrip.jpg와 contact.jpg를 생성), 그 다음 launch-review 눈 확인 체크리스트.
  • 권리: docs/rights.md.
  • 취향은 소유자의 몫: 체크리스트 통과는 영화가 좋다는 증거가 아닙니다. 무엇이 잘못 읽혔는지 추측하지 말고 물어보고, 라운드당 하나의 변수만 변경합니다.

라운드 비용이 드는 규칙

  • whisper로 단어의 시간을 절대 추측하지 마세요. skills/launch-voice/scripts/force_align.py를 사용하세요; whisper는 키워드를 0.3초 늦게 배치할 수 있으며, 시청자는 이를 "박자에 맞지 않는다"고 인식합니다.
  • 내레이터의 목소리가 아닌 새 라인은 명확하더라도 회귀(regression)입니다. 동일한 목소리와 설정으로 다시 녹음하거나, 내레이터의 기존 라인에서 복제하세요.
  • UI 애니메이션이 이미 말하고 있는 내용을 텍스트 카드로 다시 말하지 마세요. 몇 초 이상 지속되는 단조로운 스트레치는 피하세요: 확대, 색상 추가, 배경 변경.
  • 푸티지의 드로잉이나 벡터 대체물은 싸 보이고, 가짜처럼 보이는 포토리얼 사람은 더 나쁩니다. 리얼리즘이 실패할 때는 저렴하게 가기보다 스타일화(3D 애니메이션)하세요.
  • 훅별로 빌드 및 렌더링(index-<hook>.html)하여 두 훅의 병렬 작업이 렌더를 덮어쓰지 않도록 합니다.

파일 위치

무엇위치
브랜드 키트(색상, 폰트, 로고, 카피, 스크린샷, 미리보기)brand/ (brand.json, preview.png)
바디: 라인과 비트film/film.json
훅film/hooks/<name>/hook.json
템플릿, 빌드, 오디오, 배치 렌더film/templates/body.html, film/build.py, film/audio.py, film/render.sh
보이스 테이크 및 정렬된 단어film/vo/body/ (line-<id>.wav, lines.json)
음악 테이크film/score/
렌더 결과물film/renders/
웹사이트 → 브랜드 키트tools/brand-from-url.mjs, 스킬 launch-brand
도구 매뉴얼(스토리, 보이스, 스코어, 사운드, 믹스, 리뷰, 월드, 모션)skills/launch-*/
설정, 비용, 권리docs/setup.md, docs/costs.md, docs/rights.md

단계별 스킬

이 스킬 아래의 도구 매뉴얼입니다. 이 페이지와 충돌할 경우 이 페이지가 우선합니다.

스킬용도
launch-brand웹사이트 → brand/brand.json, 로고, 폰트, 스크린샷, 미리보기 시트
launch-story브리프, 스토리 스파인, 스크립트, 마디 그리드의 비트 시트, 스토리보드, 레퍼런스 연구
launch-voice캐스팅, 라인당 한 테이크, 라인 맞추기, 강제 정렬, 스크래치 보이스
launch-score액트 맵에 맞춘 음악, 컷 지점의 드롭, 스크래치 배경음
launch-soundSFX 팔레트, 이벤트 맵, 큐 시트, 생성된 키트
launch-mix버스, 덕킹, 로고 드롭아웃, -14 LUFS 마스터, 먹스
launch-review렌더 또는 레퍼런스 영화 측정, 눈 확인 체크리스트, 갭 목록, 스코어카드
launch-world배경, 플레이트, Blender 유리, 3D 샷, 셰이더 레이어
launch-motion이즈 토큰, 연속성, 카메라, 타입, 커서, 시그니처 무브, HyperFrames 블록

참고 자료

  • references/brand-core.md: 브랜드 역할을 영화 요소에 매핑, 브랜드 정보 부족 시 기본값.
  • references/body.md: film.json, 비트 유형, 타이밍, 명령, 비트 변경 방법.
  • references/hooks.md: hook.json, 음악 배경 규칙, 훅 스타일 및 각 스타일의 제작 방법.
  • references/generation.md: Higgsfield 모델, 비용 및 효과가 있었던 레시피, 무료 대체 방법.
  • references/lessons.md: 실제 런칭 영화에서 승인 및 거부된 패턴.
  • references/hyperframes-notes.md: 템플릿이 의존하는 HyperFrames 계약.

Individual skills in this repo

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

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

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.

관련 스킬