Communitygithub.com

비디오 스토리보드

에이전트가 비디오 스토리보드를 기획, 제작 또는 편집할 때 사용하는 기술로, 구체적인 산출물로 비트 시트와 쇼트 리스트를 제공합니다. 절차는 비디오 스토리보드, 운영 절차, 1단계 - 한 줄 목표와 플랫폼 확정을 거쳐 진행됩니다. 새로운 작업에 이 기술이 필요할 때 사용하세요.

비디오 스토리보드란 무엇인가요?

이 스킬은 AI 에이전트가 데모, 발표 또는 런칭 비디오를 기획할 때 체계적인 스토리보드를 작성할 수 있도록 설계되었습니다. 주요 기능은 비트 시트(5개 비트 구조: 후크, 문제, 공개, 증명, CTA)와 쇼트 리스트를 생성하고, 각 장면의 유형(타이틀, 텍스트, UI, 증명, CTA)에 따라 최적의 지속 시간을 할당하는 것입니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, `remotion-setup`, `remotion-compose`, `remotion-render`와 같은 Remotion 기반 도구와 긴밀하게 연동됩니다. 스킬의 핵심은 동영상 제작 전에 장면 계획을 먼저 수립하여 재렌더링을 방지하고, 후크가 3초 이내에 로고가 아닌 결과/긴장/주장으로 시작되도록 보장하며, 각 장면에 실제 단어와 구체적인 시각적 설명을 포함시키는 것입니다. 최종 산출물은 `scene-plan.json` 파일로, Remotion 컴포지션이 읽을 수 있는 구조화된 JSON입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ensinohi-lab/thesis-skills/tree/HEAD/video-storyboard

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

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

문서

비디오 스토리보드은(는) 무엇을 하나요?

단 한 프레임도 애니메이션화하기 전에 이 작업을 수행하세요. 데모 비디오는 계획에 따라 성패가 갈립니다. 잘못된 순서, 빠진 후크, 또는 40초 런타임은 모션이 아무리 깔끔해도 동영상을 망칩니다. 당신은 어떤 장면이 존재하고, 어떤 순서로, 얼마나 오래 지속되며, 각 장면이 무엇을 말할지 결정하는 기술 레이어입니다. 그런 다음 구체적인 장면 계획을 실제로 제작할 메커닉 팩(remotion-setup, remotion-compose, remotion-render)에 전달합니다.

기획 의도가 있을 때 적극적으로 실행하세요: "내 데모 스토리보드 작성해 줘", "비디오 계획 세워 줘", "어떤 장면이 필요해?", "런칭 비디오 구성해 줘", "이 기능을 장면으로 나눠 줘." 사용자가 바로 "이거 애니메이션화해 줘"라고 하더라도 먼저 비트 시트를 실행하세요. 스토리보드는 2분이면 완료되고 재렌더링을 방지합니다.

전체 예제로 작업하세요: Sentinel이라는 AI 코드 리뷰 도구에 대한 30초 런칭 비디오. 이 도구는 병합 전에 위험한 diff를 플래그합니다.

운영 절차

순서대로 실행하세요. 비트가 확정되기 전에 카피를 작성하지 말고, 비트가 존재하기 전에 지속 시간을 설정하지 마세요. 페이싱은 구조의 함수이지 그 반대가 아닙니다.

1단계 - 한 줄 목표와 플랫폼 확정

비트 전에 두 가지를 고정합니다:

  1. 단 하나의 핵심 메시지. 시청자가 반드시 기억해야 할 한 문장: "Sentinel은 리뷰어가 놓친 버그를 잡아냅니다." 한 줄로 말할 수 없다면 비디오에 중심이 없는 것입니다. 모든 하위 항목은 이 한 줄을 지원해야 합니다.
  2. 플랫폼 및 화면 비율. 사이트 히어로나 YouTube용 가로 16:9(1920×1080), 소셜/Shorts용 세로 9:16(1080×1920), 피드용 정사각형 1:1. 이는 remotion-compose가 작성할 캔버스를 설정하고 런타임을 제한합니다. 소셜은 15-30초, 히어로 루프는 20-40초, 기능 워크스루는 최대 60초.

2단계 - 비트 시트 작성 (5비트 구조)

모든 데모, 발표, 런칭 비디오는 이 5개의 비트 버전입니다. 이유 없이 비트를 생략하지 말고, 후크 이후 순서를 바꾸지 마세요.

  1. 후크 (첫 3초). 비디오에서 가장 중요한 3초입니다. 시청자는 여기서 계속 볼지 결정합니다. 로고가 아닌 결과, 긴장, 또는 대담한 주장으로 시작하세요. "귀하의 리뷰어가 방금 버그를 승인했습니다"가 "Sentinel 소개"보다 낫습니다. 로고는 구석에 있을 수 있습니다. 로고는 후크가 아닙니다.
  2. 문제. 시청자가 이미 느끼고 있는 불편함을 구체적으로 명명하세요. "위험한 diff가 금요일 오후 5시 리뷰를 통과합니다." 하나의 비트, 하나의 불편함.
  3. 공개. 제품을 전환점으로 소개하세요. 여기서 이름과 핵심 메커니즘이 등장합니다. 그 기능이 작동하는 모습을 보여주세요.
  4. 증명. 주장을 신뢰할 수 있게 만드세요. 실제 전/후, 실제 숫자, 실제 화면. 대부분의 비디오가 건너뛰는 비트이며, 전환을 유도하는 비트입니다. 실제 제품 데이터를 사용하고, 조작된 지표는 절대 사용하지 마세요.
  5. CTA. 하나의 액션, 하나의 URL. "Sentinel 무료 체험하기 → sentinel.dev" 두 가지 요청은 절대 안 됩니다.

더 긴 워크스루의 경우 공개 및 증명 비트가 기능마다 반복됩니다(기능 1 공개 → 증명, 기능 2 공개 → 증명). 후크, 문제, CTA는 단일로 유지됩니다.

3단계 - 각 비트에 장면 유형 및 목표 지속 시간 할당

각 비트는 하나 이상의 장면이 됩니다. 장면 유형은 페이싱을 결정합니다. 텍스트는 읽는 시간이 필요하고, UI 데모는 머무는 시간이 필요하며, 로고는 빠릅니다. 다음 목표를 사용하세요(30fps 기준; durationInFrames = 초 × fps):

장면 유형목표 지속 시간이유
후크 / 타이틀 카드2.5-3.5초한 줄을 읽을 수 있을 만큼 길고, 시작을 타이트하게 유지할 만큼 짧음
텍스트 문장2.5-4초~2.5단어/초 읽기 속도; 7단어 줄은 약 3초 필요
UI / 제품 데모4-6초눈이 화면과 그 안의 움직임을 파악하는 데 머무는 시간 필요
증명 / 데이터3-5초숫자나 전/후는 인식하는 데 박자 필요
로고 / CTA 아웃트로2.5-4초URL을 읽고, 숨 쉬게 하고, 종료

페이싱 규칙: 후크가 가장 빠른 컷, 증명이 가장 느린 컷입니다. 전체가 길어지면 모든 장면의 속도를 높이지 말고 장면 하나를 잘라내세요. 서두른 데모는 불안해 보입니다.

4단계 - 쇼트 리스트 작성 (장면별 카피 + 시각적 설명)

각 장면에 대해 네 가지 필드를 고정하세요: 해당 비트, 장면 유형, 화면상 카피(실제 단어 - 사용자에게 물어보고, 주장을 절대 날조하지 마세요), 그리고 remotion-compose에 무엇을 렌더링할지 알려주는 한 줄 시각적 설명. 이것이 산출물입니다. 시각적 설명은 코드가 아닌 브리프입니다: "터미널이 git diff를 타이핑하고, 위험한 줄 하나가 빨간색으로 강조됨" - remotion-compose가 interpolate/spring 메커니즘을 결정합니다.

5단계 - JSON 장면 계획 출력

아래 생성기를 실행하여 쇼트 리스트를 구조화된 scene-plan.json으로 변환하세요. 이것이 전달되는 아티팩트입니다. remotion-compose는 이를 장면 계획으로 읽고(장면당 하나의 <Sequence>, from/durationInFrames 이미 계산됨), 장면별 motion 힌트는 motion-design-principles 또는 motion-color-and-light 결정이 연결되는 곳입니다. 프로젝트 옆에 저장하여 메커닉 팩이 이를 가져갈 수 있도록 하세요.

6단계 - 전달

사용자에게 비트 시트, 쇼트 리스트 테이블, JSON을 제공하세요. 그런 다음 명시적으로 전달하세요: "여기 장면 계획이 있습니다. 프로젝트가 아직 스캐폴딩되지 않았다면 remotion-setup, 그런 다음 remotion-compose가 이 JSON을 컴포지션으로 바꾸고 remotion-render가 내보냅니다. 애니메이션화하기 전에 페이싱이나 카피를 조정하고 싶으신가요?" 비디오가 특히 제품 데모이고 화면에 무엇을 보여줄지에 대한 감독의 시선이 필요하다면 product-demo-director와 페어링하세요. 운동감 있는 타이틀 처리는 kinetic-typography로, 사운드 베드와 비트 동기화 컷은 sound-and-music-sync로, 소셜용 세로 재편집은 social-video-formatter로 보내세요.

품질 기준

스토리보드는 다음이 모두 충족될 때 A+입니다:

  • 후크가 첫 3초 이내에 전달되고 로고가 아닙니다. 결과, 긴장 또는 주장으로 시작합니다.
  • 5개의 비트가 모두 존재하거나, 누락된 각 비트에 대해 명시된 이유가 있습니다(티저는 정당하게 증명을 생략할 수 있음).
  • 모든 장면에 실제 단어 카피 라인과 구체적인 시각적 브리프가 있습니다. "여기에 UI"나 조작된 지표는 안 됩니다.
  • 전체 런타임이 플랫폼 상한선에 맞고, 지속 시간이 장면 유형 테이블(후크 빠름, 증명 느림)을 따르며, 3초마다 균일하게 자르지 않습니다.
  • CTA는 단일 액션과 단일 URL입니다.
  • JSON이 유효하고 합산된 지속 시간이 remotion-compose가 등록할 컴포지션 총계와 일치합니다. 불일치는 렌더링 문제 #1입니다.

하지 말아야 할 것

  • 로고나 느린 페이드인 타이틀로 시작하지 마세요. 후크 전에 시청자를 잃습니다.
  • 증명 비트에 숫자, 사용후기 또는 제품 주장을 날조하지 마세요. 실제 데이터를 요청하거나 비트를 제거하세요.
  • 여기서 .tsx를 작성하거나, interpolate 범위를 선택하거나, spring damping을 설정하지 마세요. 이는 remotion-compose의 역할입니다. 이 스킬은 코드가 아닌 계획을 출력합니다.
  • 모든 장면을 동일한 속도로 진행하지 마세요. 3초 균일 컷은 데모를 슬라이드쇼처럼 보이게 만듭니다.
  • 두 개의 CTA나 두 개의 URL을 쌓지 마세요. 하나의 요청이 전환되고, 두 개는 주의를 분산시킵니다.
  • 더 많은 내용을 담기 위해 런타임이 플랫폼 상한선을 초과하지 않도록 하세요. 대신 장면을 하나 자르세요.

생성기

자체 포함 Node 스크립트. scene_plan.js로 저장하고, 해당 비디오에 맞게 beats 배열을 편집한 후 node scene_plan.js > scene-plan.json을 실행하세요. 종속성 없음. 프레임 오프셋을 계산하고, 총계를 검증하며, remotion-compose가 사용하는 계획을 출력합니다.

// 스토리보드 -> 장면 계획. `meta`와 `beats`를 편집한 후:
//   node scene_plan.js > scene-plan.json
const meta = {
  title: 'Sentinel Launch',
  fps: 30,
  width: 1920,   // 9:16 세로의 경우 1080, 정사각형의 경우 1080
  height: 1080,  // 9:16 세로의 경우 1920, 정사각형의 경우 1080
}

// 장면당 한 행. `seconds`는 장면 유형 테이블을 따릅니다.
// `motion`은 motion-design-principles / motion-color-and-light에 대한 힌트입니다.
// 코드가 아닌 브리프입니다.
const beats = [
  { beat: 'hook',    type: 'title',   seconds: 3.0, copy: '귀하의 리뷰어가 방금 버그를 승인했습니다.', visual: '어두운 화면, 코드 한 줄이 타이핑됨; 한 줄이 빨간색으로 변함.', motion: 'snappy, 낮은 damping의 빨간색 플래그' },
  { beat: 'problem', type: 'text',    seconds: 3.5, copy: '위험한 diff가 금요일 오후 5시 리뷰를 통과합니다.', visual: '달력/시계 모티프, 병합됨으로 표시된 PR.', motion: '잔잔한 페이드, 오버슈트 없음' },
  { beat: 'reveal',  type: 'ui',      seconds: 5.0, copy: 'Sentinel은 병합 전에 모든 diff를 검토합니다.', visual: 'Sentinel이 동일한 diff를 스캔하고, 이유와 함께 위험한 줄을 표시합니다.', motion: '스캔 스윕, 그런 다음 정지' },
  { beat: 'proof',   type: 'proof',   seconds: 4.5, copy: '실제 PR에서 발견했습니다. 배송되기 전에.', visual: '전/후: 빨간색 플래그 -> 수정된 diff, 실제 스크린샷.', motion: '느린 크로스 디졸브, 유지' },
  { beat: 'cta',     type: 'cta',     seconds: 3.0, copy: 'Sentinel 무료 체험하기 -> sentinel.dev', visual: '브랜드 색상의 로고 + URL.', motion: '부드러운 팝, 깔끔하게 종료' },
]

const fps = meta.fps
let from = 0
const scenes = beats.map((b, i) => {
  const durationInFrames = Math.round(b.seconds * fps)
  const scene = {
    id: `${i + 1}-${b.beat}`,
    beat: b.beat,
    type: b.type,
    from,
    durationInFrames,
    seconds: b.seconds,
    copy: b.copy,
    visual: b.visual,
    motion: b.motion,
  }
  from += durationInFrames
  return scene
})

const durationInFrames = from
const totalSeconds = durationInFrames / fps
const hook = scenes[0]
const warnings = []
if (hook.beat !== 'hook') warnings.push('첫 번째 장면이 후크가 아닙니다.')
if (hook.seconds > 3.5) warnings.push('후크가 3.5초보다 깁니다. 오프닝을 타이트하게 하세요.')
if (scenes.filter((s) => s.beat === 'cta').length > 1) warnings.push('CTA가 두 개 이상입니다.')
if (!scenes.some((s) => s.beat === 'proof')) warnings.push('증명 비트가 없습니다. 주장이 전환되지 않을 수 있습니다.')
if (totalSeconds > 60) warnings.push(`런타임 ${totalSeconds}초가 60초 상한선을 초과합니다. 장면을 하나 자르세요.`)

const plan = {
  composition: {
    id: meta.title.replace(/[^A-Za-z0-9]/g, ''),
    fps,
    width: meta.width,
    height: meta.height,
    durationInFrames, // remotion-compose가 <Composition>에 이 값을 정확히 등록합니다.
  },
  scenes,
  meta: { totalSeconds, sceneCount: scenes.length, warnings },
}

process.stdout.write(JSON.stringify(plan, null, 2) + '\n')
if (warnings.length) console.error('경고:\n  - ' + warnings.join('\n  - '))

작업 예제 출력

위 beats를 사용하여 스크립트는 scene-plan.json을 작성합니다:

{
  "composition": {
    "id": "SentinelLaunch",
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "durationInFrames": 570
  },
  "scenes": [
    { "id": "1-hook",    "beat": "hook",    "type": "title", "from": 0,   "durationInFrames": 90,  "seconds": 3.0, "copy": "귀하의 리뷰어가 방금 버그를 승인했습니다.", "visual": "어두운 화면, 코드 한 줄이 타이핑됨; 한 줄이 빨간색으로 변함.", "motion": "snappy, 낮은 damping의 빨간색 플래그" },
    { "id": "2-problem", "beat": "problem", "type": "text",  "from": 90,  "durationInFrames": 105, "seconds": 3.5, "copy": "위험한 diff가 금요일 오후 5시 리뷰를 통과합니다.", "visual": "달력/시계 모티프, 병합됨으로 표시된 PR.", "motion": "잔잔한 페이드, 오버슈트 없음" },
    { "id": "3-reveal",  "beat": "reveal",  "type": "ui",    "from": 195, "durationInFrames": 150, "seconds": 5.0, "copy": "Sentinel은 병합 전에 모든 diff를 검토합니다.", "visual": "Sentinel이 동일한 diff를 스캔하고, 이유와 함께 위험한 줄을 표시합니다.", "motion": "스캔 스윕, 그런 다음 정지" },
    { "id": "4-proof",   "beat": "proof",   "type": "proof", "from": 345, "durationInFrames": 135, "seconds": 4.5, "copy": "실제 PR에서 발견했습니다. 배송되기 전에.", "visual": "전/후: 빨간색 플래그 -> 수정된 diff, 실제 스크린샷.", "motion": "느린 크로스 디졸브, 유지" },
    { "id": "5-cta",     "beat": "cta",     "type": "cta",   "from": 480, "durationInFrames": 90,  "seconds": 3.0, "copy": "Sentinel 무료 체험하기 -> sentinel.dev", "visual": "브랜드 색상의 로고 + URL.", "motion": "부드러운 팝, 깔끔하게 종료" }
  ],
  "meta": { "totalSeconds": 19, "sceneCount": 5, "warnings": [] }
}

해석: 5개 장면, 570프레임 = 30fps에서 19초, 소셜 상한선 아래입니다. 후크는 3초이며 로고가 아닌 긴장감으로 시작합니다. 증명 비트(4.5초)가 가장 느린 컷입니다. 후크와 CTA(3초)가 가장 타이트합니다. 경고가 없으므로 remotion-compose에 사용할 준비가 되었습니다. 이 파일에서 from과 durationInFrames를 바로 읽어 <Composition durationInFrames={570}>와 장면당 하나의 <Sequence from={…} durationInFrames={…}>를 등록합니다.

템플릿: 쇼트 리스트

JSON과 함께 사람이 읽을 수 있는 테이블이 필요할 때 사용하세요. FILL 필드를 실제 비디오로 바꾸세요.

비디오 스토리보드. [FILL: 비디오 이름]. [FILL: 플랫폼 / 화면 비율]
목표 (한 줄):              [FILL: 단 하나의 핵심 메시지]
목표 런타임:               [FILL: 15-30초 소셜 / 20-40초 히어로 / 최대 60초 워크스루]

비트      장면 유형   지속 시간   화면상 카피 (실제 단어)        시각적 브리프
후크      타이틀       [FILL]초    [FILL: 결과/긴장/주장]         [FILL]
문제      텍스트       [FILL]초    [FILL: 하나의 구체적인 불편함]  [FILL]
공개      UI           [FILL]초    [FILL: 제품 + 핵심 메커니즘]   [FILL]
증명      증명         [FILL]초    [FILL: 실제 숫자 / 전-후]      [FILL]
CTA       CTA          [FILL]초    [FILL: 하나의 액션 + 하나의 URL][FILL]
  (워크스루의 경우 기능마다 공개 + 증명 반복)

총계:     [FILL]초   (JSON composition.durationInFrames / fps와 일치해야 함)
전달:     scene-plan.json -> remotion-compose

참고/첫 3초의 중요성

시청자는 처음 약 3초 동안 계속 볼지 결정합니다. 따라서 후크는 로고나 느린 페이드를 위한 자리가 아닙니다. 결과나 긴장감으로 시작하세요: 배송된 버그, 하락한 숫자, 스크롤을 멈추게 하는 주장. 로고는 내내 구석에 있을 수 있습니다. 로고를 오프닝 비트로 만드는 것은 가장 가치 있는 몇 초를 가장 설득력 없는 콘텐츠에 소비하는 것입니다. 단 하나의 비트만 제대로 맞춰야 한다면 이 비트를 맞추세요.

참고/장면 유형별 페이싱

서로 다른 장면은 화면에 머무는 시간이 다르며, 매 N초마다 균일하게 자르는 것은 슬라이드쇼처럼 읽힙니다:

  • 타이틀/후크 - 빠름. 한 줄, 날카로운 진입, 식기 전에 자르기.
  • 텍스트 - 읽는 시간 제공. 사람들은 약 2.5단어/초를 읽습니다. 7단어 줄은 약 3초, 12단어 줄은 약 5초가 필요합니다. 텍스트를 너무 짧게 하는 것이 가장 흔한 페이싱 실수입니다.
  • UI 제품 데모 - 느림. 눈이 UI를 스캔하고, 움직임을 따르고, 상태 변화를 이해하는 데 시간이 필요합니다. 특히 전환이나 로딩 상태가 있는 경우 더욱 그렇습니다. UI 데모를 3초 미만으로 자르면 아무도 무슨 일이 일어났는지 보지 못합니다.
  • 증명/데이터 - 중간. 숫자나 비교를 등록하기에 충분히 길지만, 그 이상 머물지 않도록 충분히 짧음.
  • CTA/로고 - 중간 빠름. URL을 읽고, 액션이 등록되도록 합니다. 맴돌지 마세요.

균일한 페이싱은 데모를 자동 재생 슬라이드쇼처럼 보이게 만듭니다. 후크는 snappy하게, 증명은 붙잡아 두고, CTA는 깔끔하게 종료하세요.

참고/카피 규율

데모 비디오가 거짓말처럼 느껴지면 시청자는 신뢰를 잃습니다. 증명 비트에서 숫자나 사용후기를 절대 날조하지 마세요. 증명이 "수동 검토 대비 버그 50% 감소"라고 말할 수 없다면 비트를 완전히 제거하거나 사용자에게 실제 데이터를 요청하세요. "일부 UI" 또는 "여기에 통계"와 같은 자리 표시자 카피도 금지입니다. 각 장면은 스크립트를 구성할 실제 단어를 가져야 합니다. 스토리보드는 의도를 문서화하는 것이지, 공백을 남겨두는 것이 아닙니다.

Individual skills in this repo

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

관련 스킬