Communitygithub.com

film-voiceover

영상의 화면이 승인된 후, 실제 프레임 기반 스토리보드에 대본을 작성하고, 발음을 테스트하며, TTS로 구간별 녹음하고, 타임라인에 배치하여 최종 믹싱 및 머징하는 제품 영상 내레이터 스킬입니다.

film-voiceover란 무엇인가요?

이 스킬은 제품 홍보 영상의 화면이 최종 승인된 후에 내레이션(보이스오버)을 추가하는 전체 워크플로우를 안내합니다. 먼저 스토리보드의 각 장면을 분석하고, 시청자에게 전달할 방향성(팁, 불편함, 작동 방식, 의문 해소 등)을 정한 후 실제 프레임으로 스토리보드를 구성합니다. '눈 감고 읽기' 등 5가지 자체 검증 테스트를 통과한 뒤 소유자와 방향을 확정하고 VO-SCRIPT.md에 기록합니다. 다음으로 제품명의 정확한 발음을 소유자에게 확인하고 여러 철자 변형을 TTS로 짧게 녹음하여 적절한 발음을 찾아냅니다. 마지막으로 Fish Audio TTS를 이용해 구간별로 녹음하고, 각 구절을 영상 타임라인의 키 프레임에 맞춰 배치한 후 오디오를 믹싱(-14 LUFS, ≤ -1 dBTP)하고 영상과 머징합니다. 이 스킬은 특히 Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하도록 설계되었으며, `references/writing.md`와 `product-film/references/question-bank.md` 같은 참조 문서를 활용합니다. 내레이션이 AI처럼 들리거나, 화면과 맞지 않거나, 이름을 잘못 발음하는 문제를 해결하는 데 유용합니다.

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

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

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

문서

Film voiceover (영상 내레이션)

보이스오버는 화면이 승인된 후에 작업하며, 화면에 맞춰집니다. 화면이 보이스에 맞춰 움직이지 않습니다. 소유자가 요청하지 않는 한 화면은 절대 음성에 맞춰 이동하지 않습니다. 대본을 한 글자라도 쓰기 전에 references/writing.md(거절된 모든 패턴과 전/후 예시)를 읽고, 모든 초안에 카피라이팅 및 휴머나이저 스킬을 적용하세요.

게이트 1 · 방향성 및 대본 (아직 녹음하지 않음)

  1. 모든 컷을 이해하세요. storyboard.json의 각 비트(장면)에 대해, 그 샷이 무엇을 위한 것인지 한 줄로 작성하세요. 모르겠으면 소유자에게 물어보세요. 샷이 보여준 것처럼 보이는 것에 대해 쓴 줄(예: 벽에 붙은 작은 물건들 위의 애완동물)은 거절되었습니다.
  2. 방향성. 앵글이 열려 있을 때, 시청자에게 제공하는 내용이 다른 2~4개의 완전한 방향을 작성하세요. 예: 시청자가 사용할 수 있는 팁 · 일상적인 불편함 · 작동 방식 · 의문 해소 (핵심 안전, 비용, 플랫폼). 각각에 대해: 전체 대본, 장점, 위험 요소. 선택한 것을 먼저 배치하세요.
  3. 실제 프레임으로 스토리보드에 배치 비트별로 스틸 프레임을 렌더링하고(node scripts/render.mjs --at …), storyboard.json에 방향별로 vo를 설정한 후, review/storyboard.html을 빌드하세요(film-storyboard의 스크립트). 페이지는 각 방향이 하나의 단락으로 열리며, 이는 눈 감고 읽는(read) 부분입니다.
  4. 자체 점검 references/writing.md의 다섯 가지 테스트(눈 감고 읽기, 프레임, 낯선 사람, 슬롭 스캔, 주장)로 점검하세요.
  5. 스토리보드 전송 어떤 방향을 선택할지, 무엇을 변경할지 물어보세요. product-film/references/question-bank.md의 보이스오버 질문(목소리, 대상, 톤, 보이스 양)을 물어보세요. 명확한 승인이 있을 때까지 반복하세요. 승인된 대본을 VO-SCRIPT.md에 작성하고, 각 줄의 시간 범위와 '각 주장의 출처'를 포함하세요. 커밋하세요.

게이트 2 · 발음 (전체 녹음 전)

  1. 제품명(및 기타 특이한 단어)의 발음을 소유자의 말로 물어보세요(예: "위즈-겟, hard g").
  2. 철자 변형 테스트: 각각 짧은 클립 하나씩(이름이 포함된 짧은 문장) 녹음하세요: 기본 이름, 하이픈 연결, 자음 중복(예: "Nimbet", "Nim-bet", "Nimbbet"). 한 테이크에 여러 철자를 넣으면 짧고 혼란스럽게 나옵니다. 파일 이름은 철자로 지정하세요. 전송하고 소유자가 선택합니다.
  3. 선택된 발음을 vo.json › voice.note, VO-SCRIPT.md, 그리고 향후 영상을 위한 메모리에 기록하세요. 엔진이 잘못 발음할 경우 올바른 철자를 엔진에 보내지 말고, 모든 곳에 다시 쓴 철자를 보내세요.

게이트 3 · 녹음, 배치, 믹싱

  1. 크레딧 먼저: TTS 잔액을 확인하세요. Fish Audio: 호출당 최대 ~500바이트, 바이트 단위로 청구됩니다. 전체 대본을 한 번에 호출하지 말고, 구간별로 녹음하세요(audio/vo/l1.wav, l2.wav…).
  2. 목소리: 소유자가 샘플 중에서 선택한 목소리를 사용하세요(Fish "Ethan"은 차분한 제품 영상에 승인됨). 구문별 tempo ≤ 1.1–1.15로 속도를 맞추고, 전체 테이크를 절대 빠르게 하지 마세요.
  3. 구절로 자르기: python3 scripts/vo.py --scan으로 테이크당 음성 세그먼트를 나열하고, take, from, to, text를 포함한 vo.json 구절을 작성하세요.
  4. 각 구절의 at 배치(비트 = 영상 초 × 2) 키워드가 일치하는 그림이나 화면 속 단어와 함께 나오도록 하세요. node tools/probe.mjs cuts와 "window.UNWARP(<story t>)"로 영상 시간을 구하세요. python3 scripts/vo.py를 실행하여 overlaps: none이 나올 때까지 반복하고, 구절 사이에 ≥ 0.25초 간격을 두세요.
  5. 믹싱 및 머징: python3 scripts/sfx_samples.py && python3 scripts/mix.py(-14 LUFS, ≤ -1 dBTP; 음성 0, 효과 약 -10, 음악은 소유자 선택) 후 node scripts/render.mjs --mux [--fmt 9x16]를 실행하세요.
  6. 음성이 추가된 컷 전송 대본과 각 줄이 어디에 위치하는지 표와 함께 전송하세요. 소리만으로는 판단할 수 없다고 말하고, 발음, 속도, 레벨 및 잘못된 프레임에 위치한 줄이 있는지 물어보세요. 반복하세요. vo.json과 VO-SCRIPT.md를 커밋하세요.

나중에 화면이 변경될 경우

다시 프로브하고, 구절의 at을 다시 배치하고, 다시 믹싱하고, 다시 머징하세요. 9:16의 경우, 타이밍이 공유되면 동일한 audio/mix.wav가 작동합니다.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

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".

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).

관련 스킬