Communitygithub.com

영상 스토리보드

제품 영상의 스토리를 비트(시청자가 보는 것, 화면의 텍스트, 음성, 사운드, 비트가 존재하는 이유, 각 주장이 입증되는 위치)로 작성하고, 검토를 위해 프레임이 포함된 한 페이지 스토리보드를 소유자에게 전송합니다. 스토리가 열려 있는 경우 2~4가지 방향을 제시합니다. 제품 영상(product-film)의 2단계이며, 내레이션 검토 형식을 재사용합니다. 출시/프로모션 영상의 스토리, 촬영 목록, 대본을 계획하거나 소유자가 '스토리보드를 줘', '방향을 제시해 줘', '검토하고 결정하겠어'라고 말할 때 사용합니다.

영상 스토리보드란 무엇인가요?

이 스킬은 제품 출시 영상의 스토리보드를 체계적으로 작성하고 검토하는 프로세스를 제공합니다. 사용자는 영상의 각 장면(비트)을 시각적 요소, 자막, 음성 해설, 효과음과 함께 정의하고, 각 비트의 존재 이유와 주장의 근거를 명확히 명시해야 합니다. 스토리 방향이 확정되지 않은 경우 최대 4가지의 다른 방향(예: '사용자가 활용할 수 있는 팁', '일상적인 불편함')을 제시하여 소유자가 선택할 수 있도록 합니다. 모든 주장은 실제 제품에서 입증 가능해야 하며, 변경 비용이 적은 스토리보드 단계에서 대부분의 수정이 이루어지도록 설계되었습니다. 이 스킬은 Claude Code 환경에서 사용되며, Python 스크립트를 통해 JSON 형식의 스토리보드 데이터를 HTML 페이지로 변환하여 시각적 검토를 지원합니다.

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

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

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

문서

영상 스토리보드은(는) 무엇을 하나요?

스토리보드는 대부분의 소유자 수정이 이루어져야 하는 곳입니다. 문장 하나를 바꾸는 데는 1분이 걸리지만, 렌더링된 장면 하나를 바꾸는 데는 1시간이 걸리기 때문입니다. 제작 전에 보내고, 실제 프레임과 함께 보이스 녹음 전에 다시 보내세요.

좋은 제품 영상 스토리를 만드는 기준

각 비트를 이것들에 대해 확인하세요. 모든 기준은 거부된 초안에서 비롯되었습니다(product-film/references/lessons.md 참고).

  1. 시청자의 고통, 그들의 일상에서. 시청자가 말하는 방식으로 습관이나 불편함을 명명하세요. 라인을 테스트하세요: 듣고 나서 낯선 사람이 우리가 무엇을 판다고 생각할까요? "매일 같은 숫자"는 사람들이 분석 소프트웨어를 떠올리게 했으므로 실패했습니다.
  2. 역할이 오독될 수 없습니다. 실제 도구를 이름과 로고와 함께 보여주세요. 인접한 모든 라인 쌍을 확인하세요: "이미 비용을 지불하고 있는 AI에게 물어보세요. 이름은 Nimbet입니다."는 제품이 AI인 것처럼 들리게 만듭니다. 제품이 하는 일에 이름을 붙이세요.
  3. 구체적, 추상적이지 않게. "당신의 AI"라는 라벨은 불명확했습니다. Claude Desktop의 실제 창은 명확했습니다. 실제 Stripe 대시보드가 "수익"이라고 적힌 상자보다 낫습니다.
  4. 범위에는 공간이 필요합니다. 약속이 "당신이 필요한 모든 것"이라면, 8가지 이상의 사람 유형을 보여주고(각각 전체 화면 카드), 그 다음에는 작업, 생활, 재미(게임, 애완동물, 스티커)가 혼합된 많은 항목의 벽을 보여주세요. 약 6개 미만이면 "답답해 보입니다." 이는 45~65초가 필요합니다. 20초는 너무 짧습니다.
  5. 실제만. 모든 항목, 기능 및 주장은 오늘날 제품에서 작동합니다. claim 필드를 주장이 입증된 위치(파일, 문서, 테스트)로 채우세요. 스토리에 제품이 할 수 없는 것이 필요하면 소유자에게 알리세요: 만들거나 잘라내세요.
  6. 각 장면에 대해 쓰기 전에 이해하세요. 모든 비트에 대해 why를 작성하세요. 장면이 무엇을 위한 것인지 말할 수 없다면 소유자에게 물어보세요. (애완동물 라인이 사람들의 맞춤 위젯을 보여주는 장면 위에 작성되었습니다.)
  7. 모든 라인을 읽을 수 있어야 합니다. 화면 텍스트: 단어당 약 0.3초 + 1초, 완전히 보이는 시간이 1.5초 미만이어서는 안 됩니다.
  8. 행동으로 끝내고, 이름과 URL, 그리고 브랜드가 나타난 경우 주격 사용 라인을 포함하세요.

단계

  1. 읽기 승인된 브리프, reference/NOTES.md, 라이브 제품 및 사이트, 그리고 lessons 파일을 읽으세요.
  2. 비트 초안 작성 storyboard.json에 (스크립트 헤더의 형식 참고):
    { "title": "…", "subtitle": "draft 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    영상이 존재하기 전에는 still이 빠른 스케치나 참고 자료의 프레임에 메모를 추가한 것일 수 있습니다. 이후에는 항상 실제 렌더링된 프레임(node scripts/render.mjs --at …)이어야 합니다.
  3. 방향. 각도가 열려 있을 때, 아이디어가 다르고 표현만 다른 것이 아닌 2~4가지 방향을 작성하세요(예: "시청자가 활용할 수 있는 팁", "일상적인 불편함", "AI가 이미 당신에 대해 알고 있는 것"). 각각에 대해: 한 줄 아이디어, 위험성, 적합한 대상을 적으세요. 당신의 선택을 먼저 넣으세요.
  4. 페이지 빌드:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    각 방향의 내레이션이 한 문단(눈을 감고 읽기)으로 표시되고, 그 다음 각 비트와 프레임이 표시됩니다.
  5. 자체 점검 보내기 전에: 내레이션 문단만 읽어보세요. 눈을 감고도 이해가 됩니까? 오독될 수 있는 라인이 있습니까? "당신의 X, 당신의 Y" 목록, 삼항 구조, 또는 반복된 단어가 있습니까? 증거가 없는 주장이 있습니까?
  6. 검토 게이트. 페이지를 보내고(SendUserFile, display render), 어떤 방향과 어떤 비트를 변경할지 물어보세요. product-film/references/question-bank.md의 2단계 질문을 추가하세요(오프닝, 역할 표시 방법, 페르소나 형식, 캐릭터, UI 현실감). 명확한 승인을 기다리세요. storyboard.json을 커밋하세요.

승인 후

storyboard.json을 진실의 원천으로 유지하세요: 영상의 장면 타이밍과 내레이션의 구문 배치는 모두 여기서 비롯됩니다. 소유자가 나중에 비트를 변경하면 여기서 먼저 변경하고 페이지를 다시 생성하세요.

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

관련 스킬