이 스킬이 활성화되면, 항상 :pencil: 이모지로 첫 응답을 시작하세요.
비디오 스크립트 작성 (Video Scriptwriting)
프로그래매틱 비디오를 위한 비디오 스크립트 작성은 코드 기반 비디오 제작에 직접 연결되는 스크립트를 계획, 구조화 및 작성하는 방법입니다. 전통적인 시나리오 작성과 달리, 프로그래매틱 비디오 스크립트는 구조화된 데이터입니다. 모든 씬에는 렌더링 엔진이 사용할 수 있는 명시적인 지속 시간, 프레임 수, 애니메이션 설명 및 내레이션 텍스트가 있습니다. 이 스킬은 이해관계자 인터뷰, 구조화된 YAML 스크립트 생성, 페이싱 및 프레임 수 계산, 내레이션 작성, 스크립트 수정을 다룹니다.
이 스킬을 사용해야 하는 경우
다음과 같은 경우에 이 스킬을 활성화하세요:
- 사용자가 프로그래매틱 또는 코드 생성 비디오용 스크립트를 작성하려는 경우
- 비디오의 씬 구조, 타이밍 또는 전환을 계획해야 하는 경우
- 구조화된 형식(YAML, JSON)의 스토리보드 생성을 요청하는 경우
- 지속 시간과 FPS로부터 프레임 수를 계산하려는 경우
- 비디오 씬을 위한 내레이션 텍스트 작성이 필요한 경우
- 다양한 콘텐츠 유형(데모, 설명형, 소셜)에 따른 비디오 페이싱에 대해 묻는 경우
- 비디오 요구사항을 수집하기 위해 인터뷰 워크플로우를 실행하려는 경우
- 기존 비디오 스크립트를 수정 또는 재구성해야 하는 경우
다음과 같은 경우에는 이 스킬을 활성화하지 마세요:
- 실사 영화 제작 또는 전통적인 시나리오 작성
- 비디오 편집 소프트웨어 튜토리얼 (Premiere, Final Cut, DaVinci Resolve)
- 팟캐스트나 음악 제작과 같은 오디오 전용 콘텐츠
- 정적 이미지 디자인 또는 정적 프레젠테이션 슬라이드
핵심 원칙
-
인터뷰 기반 - 단일 씬을 생성하기 전에 7개 카테고리에 걸쳐 최대 30개의 질문으로 구성된 구조화된 인터뷰를 진행합니다. 가정을 바탕으로 스크립트를 작성하지 마세요.
-
구조화된 출력 - 모든 스크립트는
meta블록과scenes배열을 포함하는 유효한 YAML입니다. 각 씬에는id,duration,frames,narration,visual,animation,music,sfx,transition_to_next필드가 있습니다. -
시각 우선 -
narration보다 먼저visual필드를 작성하세요. 내레이션은 시각 자료를 보완해야 하며, 화면에 보이는 내용을 중복해서 설명하지 않아야 합니다. -
페이싱 인식 - 씬 수와 씬당 지속 시간을 비디오 유형에 맞추세요: 소셜 클립은 3-8초 씬, 설명형 영상은 5-12초 씬으로 여유를 둘 수 있습니다.
-
내레이션-시각 동기화 - 모든 내레이션 라인은 그 순간에 보이는 내용과 일치해야 합니다. 씬당 하나의 아이디어. 내레이션 타이밍은 씬 지속 시간에 맞아야 합니다.
핵심 개념
인터뷰 프레임워크
작성 전에 7개 카테고리를 통해 요구사항을 수집하세요:
| 카테고리 | 질문 수 | 예시 |
|---|---|---|
| 제품/주제 | 5-7 | 제품은 무엇인가요? 주요 기능은? 해결하는 문제는? 차별점은? |
| 대상 청중 | 3-5 | 대상 시청자는? 기술 수준은? 문제점은? |
| 비디오 목표 | 3-4 | 유형(데모/설명형/소셜/발표)? 지속 시간? 채널? |
| 톤 & 스타일 | 3-5 | 격식 또는 캐주얼? 활기참 또는 차분함? 참고 영상? |
| 자산 | 3-5 | 로고? 스크린샷? 브랜드 색상? 폰트? |
| 콘텐츠 | 4-6 | 핵심 메시지? 필수 포함 기능? CTA? 오프닝 훅? |
| 시각적 선호도 | 3-5 | 애니메이션 스타일? 색상 팔레트? 레이아웃 선호도? |
YAML 스크립트 형식
meta:
title: "문자열 - 설명적인 제목"
duration: "문자열 - 전체 지속 시간 (예: 60s)"
type: "열거형 - demo | explainer | social | announcement"
resolution: "문자열 - 예: 3840x2160, 1920x1080"
fps: "숫자 - 24, 30, 또는 60"
audience: "문자열 - 누가 시청하는지"
tone: "문자열 - 쉼표로 구분된 설명"
total_frames: "숫자 - duration_seconds * fps"
scenes:
- id: "문자열 - 고유한 케밥-케이스 식별자"
duration: "문자열 - 예: 4s, 8s"
frames: "숫자 - scene_duration_seconds * fps"
narration: "문자열 - 문장당 최대 15단어"
visual: "문자열 - 시청자가 화면에서 보는 내용"
animation: "문자열 - 요소가 어떻게 움직이는지, 프레임 참조 포함"
music:
track: "문자열 - 음악 트랙 이름"
volume: "숫자 - 0.0 ~ 1.0"
duck: "불리언 - 내레이션 중 음악 낮추기"
sfx:
- type: "문자열 - 효과음 이름"
at: "문자열 - 씬 내 타임스탬프"
duration: "문자열 - 재생 시간"
transition_to_next: "열거형 - hard-cut | cross-dissolve | fade-to-black | wipe-left | wipe-right | none"
비디오 유형별 씬 페이싱
| 비디오 유형 | 지속 시간 | 씬 수 | 씬당 시간 | 비고 |
|---|---|---|---|---|
| 제품 데모 | 30-120초 | 6-15 | 5-10초 | 기능 중심, 명확한 CTA |
| 설명형 영상 | 60-180초 | 8-20 | 5-12초 | 개념 중심, 더 많은 여유 |
| 소셜 클립 | 15-60초 | 3-8 | 3-8초 | 처음 3초 내 훅, 빠른 페이싱 |
| 발표 영상 | 15-45초 | 3-6 | 4-8초 | 강렬함, 단일 메시지 집중 |
프레임 계산
total_frames = duration_seconds * fps
scene_frames = scene_duration_seconds * fps
예시: 60초 비디오, 30fps = 총 1800프레임
| 지속 시간 | 24fps | 30fps | 60fps |
|---|---|---|---|
| 4초 | 96 | 120 | 240 |
| 8초 | 192 | 240 | 480 |
| 30초 | 720 | 900 | 1800 |
| 60초 | 1440 | 1800 | 3600 |
| 90초 | 2160 | 2700 | 5400 |
씬 프레임 수의 합계가 meta의 total_frames와 일치하는지 항상 확인하세요.
일반적인 작업
1. 인터뷰 워크플로우 실행
7개 카테고리를 순서대로 진행합니다. 한 번에 하나씩 질문하고, 답변을 요약한 후 다음으로 넘어갑니다. 전체 30개 질문 프레임워크는 references/interview-questions.md를 참조하세요. 시간이 촉박한 경우 압축 버전으로 10가지 필수 질문을 사용합니다: 제품명, 주요 기능, 해결하는 문제, 대상 시청자, 기술 수준, 비디오 유형, 지속 시간, 채널, 핵심 메시지, CTA.
2. 제품 데모 스크립트 생성
meta:
title: "제품 데모 - Acme 대시보드"
duration: "60s"
type: demo
resolution: 3840x2160
fps: 30
audience: "SaaS 창업자 및 제품 관리자"
tone: "전문적, 확신감, 미니멀"
total_frames: 1800
scenes:
- id: intro
duration: "4s"
frames: 120
narration: "Acme를 만나보세요, 스스로 구축하는 대시보드입니다."
visual: "따뜻한 오프화이트 배경에 로고가 중앙에 위치, 투명에서 페이드 인"
animation: "30프레임에 걸쳐 페이드 인, 90프레임 동안 유지"
music:
track: "upbeat-corporate"
volume: 0.4
duck: false
sfx: []
transition_to_next: "hard-cut"
- id: feature-1
duration: "8s"
frames: 240
narration: "필요한 것을 설명하기만 하세요. Acme가 나머지를 처리합니다."
visual: "프롬프트 입력, 텍스트 입력 중인 브라우저 목업"
animation: "브라우저가 아래에서 위로 20프레임 동안 슬라이드, 40프레임부터 타이핑 시작"
music:
track: "upbeat-corporate"
volume: 0.2
duck: true
sfx:
- type: "keyboard-typing"
at: "1.3s"
duration: "3s"
transition_to_next: "cross-dissolve"
- id: feature-2
duration: "8s"
frames: 240
narration: "드래그, 드롭, 크기 조정. 당신의 레이아웃, 당신의 규칙."
visual: "커서가 위젯을 재배열하고 있는 대시보드 편집기"
animation: "30프레임에서 커서가 위젯으로 이동, 60프레임에 걸쳐 새 위치로 드래그"
music:
track: "upbeat-corporate"
volume: 0.2
duck: true
sfx:
- type: "soft-click"
at: "1.0s"
duration: "0.2s"
transition_to_next: "cross-dissolve"
- id: cta
duration: "6s"
frames: 180
narration: "acme.dev에서 Acme를 무료로 체험하세요. 몇 분 만에 첫 대시보드를 구축하세요."
visual: "CTA 텍스트 중앙에 URL 표시, 미묘한 애니메이션 배경 그라데이션"
animation: "텍스트가 20프레임에 걸쳐 페이드 인, 배경 그라데이션이 천천히 변화"
music:
track: "upbeat-corporate"
volume: 0.4
duck: false
sfx: []
transition_to_next: "fade-to-black"
전체 데모 스크립트는 일반적으로 6-15개의 씬으로 구성됩니다. 동일한 YAML 구조를 따라 문제점, 사회적 증명, 가격, 아웃트로 씬을 추가하여 확장하세요.
3. 소셜 클립 스크립트 생성
meta:
title: "30초 Acme"
duration: "30s"
type: social
resolution: 1080x1920
fps: 30
audience: "소셜 피드를 스크롤하는 개발자"
tone: "에너제틱, 강렬함, 모던"
total_frames: 900
scenes:
- id: hook
duration: "3s"
frames: 90
narration: "처음부터 대시보드를 구축하는 것은 그만두세요."
visual: "선명한 그라데이션 배경 위의 굵은 텍스트"
animation: "텍스트가 위에서 8프레임 동안 강하게 내려오며, 4프레임 동안 화면 진동"
music:
track: "electronic-pulse"
volume: 0.5
duck: true
sfx:
- type: "impact-hit"
at: "0.2s"
duration: "0.3s"
transition_to_next: "hard-cut"
- id: demo
duration: "12s"
frames: 360
narration: "필요한 것을 입력하세요. Acme가 실시간으로 구축합니다."
visual: "화면 녹화: 프롬프트 입력, 대시보드가 실시간으로 생성"
animation: "120프레임 동안 타이핑, 나머지 240프레임 동안 대시보드 구축"
music:
track: "electronic-pulse"
volume: 0.3
duck: true
sfx:
- type: "keyboard-typing"
at: "0.5s"
duration: "4s"
transition_to_next: "hard-cut"
- id: result
duration: "8s"
frames: 240
narration: "완전한 상호작용. 실시간 데이터. 공유 준비 완료."
visual: "호버 상호작용이 있는 완성된 대시보드, 데이터가 실시간으로 업데이트"
animation: "커서가 호버하여 툴팁 트리거, 120프레임에서 데이터 새로고침"
music:
track: "electronic-pulse"
volume: 0.3
duck: true
sfx: []
transition_to_next: "hard-cut"
- id: cta
duration: "7s"
frames: 210
narration: "acme.dev에서 무료로 체험하세요."
visual: "크게 중앙에 CTA 텍스트, 아래에 URL, 브랜드 그라데이션 배경"
animation: "텍스트가 0에서 전체 크기로 15프레임에 걸쳐 확대, 유지"
music:
track: "electronic-pulse"
volume: 0.5
duck: false
sfx: []
transition_to_next: "none"
4. 지속 시간으로부터 프레임 수 계산
입력: duration = 60s, fps = 30
출력: total_frames = 1800
씬 분해:
intro: 4s * 30 = 120 프레임
feature-1: 8s * 30 = 240 프레임
feature-2: 8s * 30 = 240 프레임
proof: 6s * 30 = 180 프레임
cta: 6s * 30 = 180 프레임
---
합계: 32s = 960 프레임 (남은 840 프레임은 더 많은 씬 필요)
항상 합계를 확인하세요. 씬이 합계에 맞지 않으면 조정하거나 씬을 추가하세요.
5. 효과적인 내레이션 텍스트 작성
규칙:
- 문장당 최대 15단어 - 그 이상은 시간 내에 읽을 수 없음
- 능동태, 현재 시제 - "Acme가 대시보드를 구축합니다" (x "구축될 것입니다")
- 내레이션을 시각 자료와 일치 - 화면에 있는 내용에 대해 말할 것
- 씬당 하나의 아이디어 - 하나의 라인에 두 가지 개념을 넣지 않을 것
- 이점을 먼저 제시 - "시간 추적 기능"보다 "주당 10시간 절약"
- 일시 정지 포함 - 여유를 위해 빈 내레이션 (
"") 사용 - 읽기 속도 - 초당 약 2.5단어
| 나쁨 | 좋음 | 이유 |
|---|---|---|
| "저희 제품은 팀이 더 빠르게 대시보드를 구축할 수 있도록 설계되었습니다" | "몇 주가 아닌 몇 분 만에 대시보드를 구축하세요." | 너무 김, 수동태 |
| "오른쪽 상단 모서리에 있는 더하기 버튼을 클릭하세요" | "한 번의 클릭으로 위젯을 추가하세요." | 시각 자료가 위치를 보여주도록 함 |
| "보시다시피 데이터가 실시간으로 업데이트됩니다" | "실시간 데이터. 항상 최신." | "보시다시피"는 불필요한 표현 |
6. 씬 전환 계획
| 전환 | 사용 시기 |
|---|---|
hard-cut | 동일 주제, 빠른 페이싱, 또는 급격한 대비 |
cross-dissolve | 부드러운 주제 변경, 관련 콘텐츠 흐름 |
fade-to-black | 섹션 종료, 극적인 멈춤, 최종 씬 |
wipe-left / wipe-right | 전후 비교, 타임라인 진행 |
none | 비디오의 마지막 씬 |
규칙: 일관성을 위해 비디오당 최대 2가지 전환 유형만 사용하세요.
7. 피드백 기반 스크립트 수정
- 피드백 유형 식별: 페이싱, 내레이션, 시각 자료, 구조, 또는 톤
- YAML에서
id로 영향을 받는 씬 찾기 - 영향을 받는 필드에만 변경 적용, 프레임 계산 유지
- 재검증: 씬 지속 시간의 합이 여전히 전체 지속 시간과 일치해야 함
- 지속 시간이 변경된 경우 프레임 재계산
- 변경 사항 문서화:
# 수정: 피드백에 따라 인트로를 6초에서 4초로 단축 (v2)
- id: intro
duration: "4s" # 이전 6s
frames: 120 # 이전 180
안티패턴 / 일반적인 실수
| 실수 | 잘못된 이유 | 대신 할 일 |
|---|---|---|
| 내레이션을 시각 자료보다 먼저 작성 | 비디오가 인물 중심이 됨 | visual을 먼저 작성한 후 내레이션으로 보완 |
| 12초 이상의 씬 | 시청자 주의력 분산, 페이싱이 느려짐 | 두 개의 짧은 씬으로 분할 |
| 불일치하는 프레임 수 | 렌더링 엔진이 잘못된 타이밍을 생성하거나 충돌 | 항상 frames = duration * fps 계산 및 합계 확인 |
| 문장당 15단어 초과 내레이션 | 씬 지속 시간 내에 읽을 수 없음 | 더 짧은 문장으로 분할 |
| 처음 3초 내 훅 부재 | 소셜 시청자는 스크롤, 임베드 시청자는 이탈 | 대담한 진술, 질문 또는 시각적 놀라움으로 시작 |
| 일관성 없는 전환 | 비디오가 어설프고 아마추어처럼 느껴짐 | 비디오당 최대 2가지 전환 유형 사용 |
| 인터뷰 건너뛰기 | 목표를 놓친 일반적인 스크립트 생성 | 항상 먼저 요구사항 수집 |
| 빈 시각 설명 | 렌더링 엔지니어가 씬을 구축할 수 없음 | 레이아웃, 색상, 움직임, 요소에 대해 구체적으로 설명 |
주의사항
-
프레임 수 반올림 - 지속 시간이 균등하게 나누어지지 않는 경우 (예: 24fps에서 3.5초 = 84프레임), 가장 가까운 정수로 반올림하고 마지막 씬을 조정하세요. 분수 프레임을 남기지 마세요 - 렌더링 엔진이 잘라내거나 오류를 발생시킵니다.
-
내레이션 타이밍 오버플로우 - 초당 2.5단어의 속도에서 4초 씬은 약 10단어를 담을 수 있습니다. 4초 씬에 20단어를 쓰면 내레이션이 급해지거나 잘립니다. 항상 단어 수를 씬 지속 시간과 비교하세요.
-
세로 vs 가로 해상도 - 소셜 클립 (TikTok, Reels, Shorts)은 1080x1920 (세로)을 사용합니다. YouTube/웹사이트 임베드는 1920x1080 또는 3840x2160을 사용합니다. 해상도 설정 전에 배포 채널을 확인하세요.
-
음악 오리 충돌 - 모든 씬에
duck: true가 있으면 음악 볼륨이 계속 오르내립니다. 내레이션이 있을 때만 오리를 사용하세요. 내레이션이 빈 씬은duck: false여야 합니다. -
전체 지속 시간 표류 - 수정 후 씬 지속 시간의 합이 전체 지속 시간과 일치하지 않을 수 있습니다. 각 수정 후 항상 프레임 수를 재검증하고 재계산하세요.
-
스크립트 시작시
meta블록 누락 -meta블록은 렌더링 엔진에 필수적인 전역 설정(해상도, FPS, 전체 지속 시간)을 제공합니다. 절대 생략하지 마세요. -
씬 식별자 충돌 - YAML 키는 고유해야 하지만
id값도 고유해야 합니다. 중복된id는 일부 렌더러에서 나중 씬이 이전 씬을 덮어쓰게 할 수 있습니다. 각 씬 ID를 확인하세요.
통합 지침
이 스킬을 다른 도구 및 시스템과 결합하여 사용하세요:
- 버전 관리 - YAML 스크립트를 마크다운 파일과 함께 Git 저장소에 보관하세요. 각 수정 사항에 의미 있는 커밋 메시지를 사용합니다.
- 렌더링 엔진 - YAML 출력은 Python (moviepy, manim), JavaScript (remotion, motion-canvas) 또는 노코드 도구를 기반으로 한 렌더링 엔진과 호환됩니다.
- 내레이션 TTS -
narration필드는 ElevenLabs, Google Cloud TTS, Amazon Polly 및 표준 텍스트 음성 변환 엔진에 직접 공급될 수 있습니다. - 자산 파이프라인 -
visual및animation설명은 그래픽 디자이너나 자동 자산 생성기를 위한 명세 역할을 합니다. - 분석 피드백 루프 - 비디오가 게시된 후 시청자 유지율 데이터(처음 3초 드롭오프, 중간 지점 이탈)를 수집하고, 이를 다음 스크립트 반복에 통합하세요.