Communitygithub.com

film-build

제품 홍보 영상을 코드로 빌드하는 도구 키트: 확정적 seek(t) 웹 페이지(실제 제품 UI, 실제 OS 크롬, 운동 텍스트, 타이핑 프롬프트, 커서, 모프 및 카메라 움직임)를 만들고, 스틸 및 드래프트로 검토한 후 60fps 모션 블러로 렌더링하고, 16:9는 그대로 둔 채 9:16으로 변환합니다.

film-build란 무엇인가요?

이 스킬은 제품 런칭/프로모션 영상을 코드로 완전히 제어하여 제작할 수 있는 종합 영상 빌드 키트입니다. 핵심 엔진은 시간(t)에 대한 순수 함수로 모든 프레임이 동일하게 렌더링되는 결정론적 방식을 채택하여, 재현 가능한 고품질 출력을 보장합니다. 키트에는 장면 정의(카메라 움직임, 모프, 타이핑 효과, 커서 움직임 포함), 렌더링(60fps 모션 블러, 드래프트 30fps), 동기화, 리뷰(접촉 시트, 빠른 동작 스트립, 9:16 안전 영역), PSNR 회귀 테스트 등 다양한 도구가 포함되어 있습니다. 특히 실제 제품 UI, 실제 OS 크롬, 실제 로고, 실제 배경화면을 사용한 사실주의를 강조하며, 하나의 소스 파일에서 16:9 및 9:16 포맷을 동시에 제작할 수 있어 촬영 없이 코드만으로 완성도 높은 마케팅 영상을 제작하는 데 최적화되어 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-build

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

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

문서

Film build

시작하기

sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film>   # 비어 있지 않은 폴더는 거부합니다
cd marketing/videos/<film> && npm i && npx playwright install chromium   # NEXT 메시지가 뜨면 실행

키트가 제공하는 파일:

파일설명
film/core.js엔진: scene({name, from, to, build, run, after}) (시간 단위: 비트 = 초 × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start()
film/film.js아래 모든 헬퍼와 4개의 예제 샷(라인, 프롬프트, 분할, 페르소나 카드)이 포함된 스타터. 각 헬퍼의 주석에는 어떤 리젝션에서 비롯되었는지 표시됩니다. 샷은 교체하고 헬퍼는 유지하세요.
film/mock.jswindow.MOCK: 실제 UI 조각(대시보드, 창, 전화기 화면)의 HTML, 화면 px 단위
film/index.htmlassets/fonts/{display,ui}.woff2에서 글꼴 로드(로컬 산세리프 대체 포함)
scripts/render.mjs--sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all
scripts/sync.mjstimeline.json을 페이지로 복사
scripts/review.py렌더링된 MP4에서 비평 키트 생성: 접촉 시트, 가장 빠른 동작 스트립, 전화기 보기, 9:16 안전 영역, 메트릭
tools/probe.mjscuts (모든 컷과 각 샷의 중간점, 비디오 초 단위) 또는 임의 표현식 (예: "window.UNWARP(12.4)")
tools/sheet.py스틸 이미지를 하나의 레이블이 있는 시트로 타일링
tools/pack_grid.py4×3 캐릭터 시트(투명 또는 흰색 배경)를 sprite()용 12셀 스트립으로 자름; 셀 크기 출력
tools/cut_cast.py한 줄로 정렬된 캐릭터들을 개별 스틸 이미지로 자름
assets/characters/4개의 예제 캐릭터(창업자, 개발자, 판매자, 학생), 360px 셀 기준 12프레임 스트립
tools/same.sh변경 전/후 스틸 간 PSNR 회귀 저장/확인

스타터의 헬퍼 (재발명하지 말고 사용하세요)

  • io (5차 in-out) — 카메라 움직임과 모프용; oq (5차 out) — 등장용; back — 약간의 오버슈트용.
  • cam(e, s, fx, fy) — 1920×1080 평면의 초점 (fx, fy)를 스케일 s로 프레임 중앙에 배치합니다. camD는 평면 가장자리를 넘지 않는 동일한 기능(커버 스케일, 9:16에서 필수).
  • posIn(e, root) — 움직이는 평면 내 요소의 위치를 읽습니다(커서 대상, 캐럿 팔로우용).
  • typed() — 단어가 한 줄에 문자 하나씩 나타나는 효과; keyed() — 실제 키보드 효과: 문자별 불규칙한 타이밍, 공백에서 더 긴 일시정지, 깜빡이는 캐럿.
  • wordsHTML() — 모든 단어를 첫 프레임부터 최종 너비로 배치하고, 해당 시간까지 투명하게 유지하여 줄이 다시 흐르지 않도록 합니다("텍스트 전환이 전혀 부드럽지 않음" 문제 해결).
  • cursor()/putCursor()/bump() — 미끄러지듯 움직이고, 일찍 도착하며, 클릭 시 15% 내려가는 실제 화살표 커서.
  • pop() — 작은 아이템이 착지하는 효과.
  • sprite(parent, src, cellW, cellH, h) / putSprite(e, t, a, z, loops) — 그려진 캐릭터: a에서 z까지 12프레임을 단계별로 진행하며, 약간의 호흡 효과로 절대 멈추지 않게 합니다. <img>이므로 엔진이 로드를 기다립니다.
  • shot(name, t0, t1, build, run) — scene을 초 단위로 래핑합니다.
  • 하단의 페이싱 워프: SLOW (전체 스트레치), EV 홀드 (읽기를 위해 순간 정지) 및 삽입; window.CUTS와 window.UNWARP는 사운드 및 보이스 배치를 위한 비디오 시간을 제공합니다.
  • PT / pk(a16, a9) — 하나의 파일에서 포맷별 값을 선택합니다.

엔진 규칙 (결정론)

영화는 t의 순수 함수입니다. 어떤 프레임이든 첫 번째로 렌더링되든 다른 프레임 후에 렌더링되든 동일하게 그려져야 합니다.

  • 2D 변환만 사용: translate3d 금지, will-change 금지, CSS 전환 금지, Math.random 금지 (인덱스의 해시 사용).
  • 시작 시 숨겨진 요소: reg(el, {o: 0}) 사용, 절대 인라인 opacity:0 사용 금지.
  • 레이아웃 측정은 after() 또는 build에서 한 번만, run 내부에서는 절대 금지 (이전 프레임을 읽음).
  • 3D 뷰: 매 프레임 insertBefore(v, firstChild)로 다시 삽입하여 캐시된 래스터가 남지 않도록 함.
  • 포함된 CSS 애니메이션 (예: 제품 위젯 자체): 일시정지하고 animation-delay: calc(-1s * var(--t)) 설정.
  • 이미지와 글꼴 로드 (decode(), document.fonts.ready)를 첫 프레임 전에 대기.
  • 제품 CSS는 고유한 루트 클래스 아래로 범위 지정; 영화 내에서 고유한 클래스명 사용 (.w가 한 번 누출됨).
  • classList.add 사용, className = 사용 금지.
  • node scripts/render.mjs --verify는 렌더링을 보내기 전에 12/12를 출력해야 합니다.

사실주의: 화면을 만들기 전에 references/realism.md를 읽으세요

간략 버전: 실제 앱을 실제 밀도로, 실제 브랜드 웹사이트의 실제 로고, 해당 OS에 존재하는 앱이 있는 OS 크롬, 실제 배경화면, 실제 런처 그리드의 실제 dp 크기의 전화기(제품 자체 렌더러로 그림), 생각보다 풍부해야 하는 제품 UI, 브랜드 마크 표시 시마다 귀속 사용 문구.

빌드 루프 (리뷰 주도)

  1. 승인된 스토리보드의 샷 목록을 film.js에 작성, 각각 shot() 사용, 핸드오프를 위해 오버랩.
  2. 먼저 스틸. node tools/probe.mjs cuts → 모든 샷 중간점과 모든 핸드오프에서 스틸 렌더링: node scripts/render.mjs --at … 후 python3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. 직접 시트를 읽으세요. 수정. 반복. (전체 렌더링 25분+ 대비 약 1-2분 소요.)
  3. 보내기 전 QA: ≤ 1.5초 간격 및 모든 핸드오프에서 영화를 단계별로 확인 (각 전환에 대해 10-15fps 접촉 시트). references/qa.md를 항목별로 확인: 오버랩, 클리핑, 빈 프레임, 읽기 시간, 텍스트 부드러움, 타이핑, 로고 표시, OS 사실주의, 전화기 크기.
  4. 스틸 전송 (시트)을 소유자에게 첫 검토용으로 보냅니다. 대기.
  5. 드래프트: node scripts/render.mjs --draft (30fps, ~4분), python3 scripts/review.py 1 --draft, 스트립 읽기. 드래프트 MP4 전송. 30fps 드래프트이며 블러가 없어(최종보다 거칠어 보임) 최종과 다르다고 명확히 표시.
  6. "최종 렌더링" 시: 백그라운드에서 node scripts/render.mjs 실행 (60fps, 모션 블러 포함; 60초 기준 약 25-35분). 렌더링 중에는 film.js를 편집하지 마세요: 계속 작업해야 한다면 먼저 프로젝트를 복사하세요.
  7. 승인된 각 라운드 후 필름 코드와 타임라인을 커밋.

페이싱

첫 컷은 거의 항상 너무 빠릅니다. 화면 텍스트는 단어당 약 0.3초 + 완전 불투명 상태에서 1초(최소 1.5초 미만 금지)가 필요합니다. 모든 샷의 타이밍을 다시 조정하는 대신 워프(SLOW 1.1–1.25, 라인에 EV 홀드)를 선호하세요. 페이스 변경 후에는 사운드와 보이스 위치가 변경되므로 probe.mjs cuts를 다시 실행하세요.

9:16: references/formats.md를 읽으세요

pk()를 사용하여 하나의 파일에서 동일한 영화를 재구성; tools/same.sh로 16:9가 변경되지 않았음을 증명 (모든 스틸 PSNR = inf); --verify --fmt 9x16; 소유자용 스틸 시트; 그 후 백그라운드에서 --fmt 9x16 최종 렌더링, 이어서 --mux --fmt 9x16.

Individual skills in this repo

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

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

관련 스킬