Communitygithub.com

듀얼 엔진 비디오 디렉터 & 제너레이터 (v4.0)

RangeForce의 Character Storytelling Engine(절차적 2D 캐릭터, 말풍선, 립싱크)과 Kinetic Motion Graphics Engine(닷 그리드, 폰 목업, 네온 그린 캡션)을 결합한 리모션 기반 만능 비디오 제작 스킬입니다. 9:16 세로형 쇼트폼(YouTube Shorts, TikTok, Instagram Reels, Facebook Ads)에 최적화되어 있습니다.

듀얼 엔진 비디오 디렉터 & 제너레이터 (v4.0)란 무엇인가요?

이 AI 스킬은 Remotion 기반의 듀얼 엔진 비디오 제작 시스템입니다. 첫 번째 엔진(Character Storytelling Engine)은 절차적 2D 플랫 캐릭터, 말풍선, 방 배경, 립싱크를 통해 심리적/교육적 내러티브를 시각화합니다. 두 번째 엔진(Kinetic Motion Graphics Engine)은 상업 광고, SaaS/e-Commerce 설명 영상, 닷 그리드, 폰 목업, 어두운 바닥 캡션 필(네온 그린 강조)을 자동 생성합니다. 이 스킬의 핵심은 데이터 기반 동적 자산 합성(Dynamic Script-Driven Asset Synthesis)입니다. 스크립트를 분석하여 각 고유 주제에 맞춤형 SVG 벡터 컴포넌트를 자동 설계하며, 오디오/SRT 싱크 또는 Cartesia Sonic TTS를 지원하고, 엄격한 이중 승인 워크플로우를 따릅니다. 주로 Claude Code, Cursor, Codex와 같은 AI Agent 플랫폼에서 사용되며, Python과 Node.js 스크립트를 조합하여 입력 JSON 생성, TTS, 타임라인 컴파일, 최종 렌더링까지 전 과정을 자동화합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/nsshan98/video-generation-skills/tree/HEAD

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

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

문서

유니버설 듀얼 엔진 비디오 디렉터 & 제너레이터 (v4.0)

Remotion 기반의 프로덕션 등급 자동 비디오 생성 스킬로, 9:16 세로형 쇼트폼 비디오(YouTube Shorts, TikTok, Instagram Reels, Facebook Ads)를 제작합니다. 두 가지 독립적인 시각 엔진을 단일 통합 프로젝트로 제공합니다.

                                  ┌────────────────────────┐
                                  │  사용자 스크립트/오디오 │
                                  └───────────┬────────────┘
                                              │
                      ┌───────────────────────┴───────────────────────┐
                      ▼                                               ▼
         [ 모드 1: 캐릭터 스토리 ]                     [ 모드 2: 키네틱 프로모 ]
      - 절차적 2D 플랫 캐릭터                 - 2D 플랫 키네틱 모션 그래픽
      - 대화 및 생각 말풍선                    - 고정 브랜드 헤더 및 워터마크
      - 100% 풀스크린 방 및 포즈               - 도트 그리드 떠다니는 캔버스
      - 선택적 자막 (중복 없음)                - 어두운 하단 캡션 필 + 네온 그린
      - 심리적/일상 내러티브                    - 스크립트 기반 맞춤형 벡터 자산

1️⃣ 엔진 모드 선택 (Dual-Engine Mode Selection)

사용자는 하나의 스킬만 설치/사용합니다. 스크립트 유형 또는 사용자 지시에 따라 자동으로 올바른 엔진이 활성화됩니다.

모드트리거 키워드스크립트 유형비주얼 메타포 및 스타일
Mode 1: 캐릭터 스토리텔링 엔진story, cartoon, drama, character, golpo, গল্প, কার্টুন캐릭터 기반 대화, 심리적 갈등, 교육적 이야기, 팟캐스트 내레이션절차적 2D 플랫 캐릭터, 입술 움직임, 말풍선, 풀스크린 침실/사무실 배경
Mode 2: 키네틱 모션 그래픽 & 프로모 엔진promo, ad, commercial, saas, kinetic, explainer, বিজ্ঞাপন, প্রমো제품 광고, SaaS/소프트웨어 데모, e-커머스 프로모, 비즈니스 전략도트 그리드 텍스처, 브랜드 헤더, 모서리 워터마크, 폰 목업, 카드 메커닉, 어두운 하단 캡션 필

[!TIP] 사용자가 특정 모드를 명시하지 않은 경우, 스크립트에 눈에 띄는 캐릭터나 대화가 있으면 **Mode 1 (Story)**를, 비즈니스 문제/제품 솔루션이 있으면 **Mode 2 (Promo)**를 자동으로 선택하며, 승인 테이블에 이를 명시합니다.


2️⃣ ⚠️ 매우 중요한 규칙: 100% 데이터 기반 유니버설 스킬 아키텍처 (Universal Data-Driven Architecture)

[!CAUTION] 새로운 스크립트마다 새로운 React 컴포넌트, 코드 파일, 별도 폴더 또는 일회성 .mjs 스크립트를 만드는 것을 엄격히 금지합니다! 이는 전역 유니버설 스킬로, 모든 사용자가 설치하여 어떤 주제의 스크립트든 실행할 수 있습니다. 모든 스크립트별 변경 사항(캐릭터 외형, 의상, 배경 테마, 대화, 액션 비트, 인포그래픽 및 선택적 카드)은 단 하나의 입력 JSON 파일에서만 구성해야 합니다.

유니버설 비디오 생성 파이프라인 (단 4가지 명령어):

  1. 스크립트에서 자동 합성 및 입력 JSON 생성 (AI Director Analyzer):
    • 스크립트의 내용, 신체 활동, 객체/소품, 감정 및 대화를 자동 분석하여 동적 스토리보드를 생성합니다:
      python3 scripts/analyze-script-director.py --script=scripts/<story-name>.txt --out=scripts/<story-name>-input.json
      
    • 또는 examples/sample-story-input.json 참조하여 씬별로 scripts/<story-name>-input.json을 직접 생성합니다.
  2. 유니버설 오디오 및 타이밍 합성:
    node scripts/tts-engine.mjs --input=scripts/<story-name>-input.json
    
    • 자동으로 Cartesia 또는 선택된 TTS를 사용하여 각 씬의 음성을 생성하고, 오디오의 정확한 초/프레임 타이밍을 입력 JSON에 저장합니다.
  3. 유니버설 타임라인 컴파일:
    node scripts/build-story-timeline.mjs --input=scripts/<story-name>-input.json
    
    • Remotion 준비 template/src/timeline.json을 생성합니다.
  4. 미리보기 확인 및 전체 렌더링:
    cd template && npx remotion render src/index.ts Main ./out/<video-name>.mp4 --concurrency=4
    

3️⃣ 모드 1: 캐릭터 스토리텔링 엔진 규칙 (Mode 1 Guidelines)

  1. 캐릭터 구성, 캐스팅 및 3명 이상 캐릭터 스테이징 (Dynamic Character Casting & Staging):
    • 스크립트 기반 캐스팅: 스크립트에 필요한 캐릭터 수를 파악하여 각각 고유한 신원을 생성해야 합니다.
    • 얼굴의 독창성: 여러 캐릭터가 있을 때 동일한 얼굴/안경을 복제해서는 안 됩니다. 나이, 헤어스타일, 의상에 명확한 차이가 있어야 합니다.
    • 안경 사용: 노인이나 특정 직업의 캐릭터에게만 안경을 착용시킵니다. 일반 고객이나 직원에게 불필요하게 동그란 안경을 씌우는 것을 엄격히 금지합니다.
    • 의상과 신원: 가게 주인(반바지/쿠르타), 판매 직원(유니폼/폴로), 고객(캐주얼 티셔츠/후드) 등.
    • 단단한 헤어라인 캡: 두피가 완전히 덮여야 합니다 (빈 초승달 자국 없음).
    • 스케일링 및 프레이밍 (1, 2 또는 3명 캐릭터):
      • 1명 캐릭터: scale: 1.85, 중앙 (center) 또는 왼쪽/오른쪽.
      • 2명 캐릭터: scale: 1.75, 왼쪽과 오른쪽 (left: 80, right: 80, bottom: 160).
      • 3명 캐릭터 (tertiaryCharacter): 9:16 프레임에서 3명이 있을 때 완벽한 구성을 위해 scale: 1.55를 사용합니다. 왼쪽에 보조 캐릭터 (left: 20), 중앙에 3번째 캐릭터 (center), 오른쪽에 주인공 (right: 20, flip: true).
    • 배경 군중 레이어 (crowd):
      • 가게에 손님 또는 사무실에 팀이 있을 때 crowd: "shoppers" | "office_team" | "village_crowd" | "classroom_students"를 추가합니다. 이는 캐릭터 뒤에 (zIndex: 12), 작은 스케일 (scale: 1.1 - 1.15), bottom: 240-260, 약간의 블러 (blur: 2px)를 적용하여 자연스러운 피사계 심도를 만듭니다.
  2. 환경 및 맥락 분석 (Dynamic Environment & Semantic Procedural Fallback):
    • 환경에 따라 사전 제작된 26개 이상의 배경 테마를 사용합니다:
      • 상점: clothing_store, electronics_store, pharmacy, grocery_store
      • 주거 및 모임: living_room, home_study, tea_stall, cafe, wedding_hall
      • 사무실 및 기관: corporate_office, hospital_clinic, police_station, classroom, deep_library
      • 마을 및 야외: village_bazaar, village_sunset, street_outdoor, bus_interior
      • 분위기 및 갈등: dark_conflict, dramatic_red, blue_melancholy, golden_sunrise
    • 스마트 시맨틱 절차적 방 생성기 (No Blind Office Fallback):
      • 완전히 새롭거나 목록에 없는 테마(예: bakery, gym, bank, courtroom, kitchen)가 주어지면 엔진은 맹목적으로 사무실로 대체하지 않습니다. 대신 테마 이름을 디코딩하여 관련 실루엣, 간판 및 인테리어 색상 벡터를 자동 생성합니다.
    • 각 씬은 화면 시작부터 끝까지 100% 풀스크린 (width: 100%, height: 100%)입니다.
  3. 카메라 흔들림 및 캐릭터 떨림 규칙 (Tone-Calibrated Screen Shake & Character Tremble - STRICT MAX 1.0-1.2 SECONDS):
    • ⚠️ 지속적인 흔들림 또는 캐릭터 떨림 금지: 어떤 상황에서도 한 씬에서 10~20초 동안 카메라를 흔들거나 캐릭터를 떨게 해서는 안 됩니다. 시청자에게 극심한 불편을 초래합니다.
    • 캐릭터 떨림 제한 (trembleX): 캐릭터의 공포, 분노 또는 충격 시 떨림은 최대 1.01.2초 (3036프레임) 동안 지속되며, 이후 부드럽게 0으로 감소하여 정상 자세로 안정됩니다.
    • 톤 체크: 일반 대화, 평범한 논쟁, 고객 대화 또는 설명 중에는 화면과 캐릭터가 완전히 정지합니다 (screenShake: false).
    • 갑작스러운 충격 제한: 극도로 강한 갑작스러운 충격 또는 충격의 경우에만 최대 1.01.2초 (3036프레임) 동안 일시적인 흔들림을 허용하며, 즉시 부드럽게 감쇠되어 카메라가 다시 안정됩니다.
  4. 대화 및 생각 말풍선 (SpeechCalloutBubble):
    • 높이 top: 650으로 말풍선의 꼬리가 말하는 캐릭터의 머리를 직접 가리키도록 합니다 (왼쪽 left: 180, 오른쪽 right: 180).
    • 화자 이름 태그: 말풍선 위에 떠다니도록 합니다 (zIndex: 60, padding: "5px 20px", border: "2.5px solid #ffffff").
  5. ⚠️ 선택적 자막 및 완벽한 음성 동기화 캡션 (Selective Subtitles & Voice-Matched Karaoke Pill):
    • 화면에 말풍선 또는 풀스크린 중앙 카드가 있을 때, 아래에 별도의 자막을 완전히 비활성화합니다 (중복 없음).
    • 위에 말풍선이나 카드가 없을 때만, 내레이션의 실제 음성 텍스트에서 동적으로 3~5단어의 강력한 구절 캡션이 아래에 나타납니다.
    • 캡션은 절대 한 줄의 정적 요약을 늘리지 않습니다. 오디오에서 발음되는 단어 그대로, 구절 단위로 실시간으로 화면에 표시됩니다.
    • 시각 효과:
      • 각 구절이 나타날 때 어두운 유리 캡슐 필이 부드러운 스프링 팝(spring 스케일)으로 진입합니다.
      • 발음되는 실시간 단어: 네온 그린 (#22C55E) 빛나는 텍스트 + 배경 필 하이라이트 + scale(1.08) 펀치.
      • 하이라이트 키워드: 생생한 호박색/황금색 배지 (#F59E0B ➔ #EA580C).
      • 구절 전환 시 빈 프레임이나 깜빡임이 없어야 합니다. 한 구절에서 다음 구절로 매끄럽게 전환됩니다.
  6. ⚠️ 입술 움직임 및 활성 화자 규칙 (Selective Speaker Lip-Sync Rule):
    • 화면에 두 사람이 있을 때, 그중 말풍성이 가리키는 사람(speechBubble.speakerPosition)의 입만 움직입니다 (isSpeaking: true).
    • 다른 청자 또는 듣는 캐릭터의 입은 조용히 닫혀 있어야 합니다 (isSpeaking: false -> 닫힌 휴식선). 두 사람의 입이 동시에 움직여서는 안 됩니다.
  7. ⚠️ 화자 대 대화 타이밍 (Narrator vs Dialogue Timing Rule):
    • 어떤 씬에서 내레이터나 화자가 3인칭으로 사건을 설명할 때, 화면의 어떤 캐릭터의 입도 움직이지 않아야 (isSpeaking: false) 하며 말풍선도 없어야 합니다.
    • 말풍선은 캐릭터의 1인칭 대화 시간에만 특정 프레임 (speechBubbles: [{ start, duration }])에 떠오르며, 해당 특정 초 동안만 입이 움직입니다. 대화가 끝나면 말풍선은 사라지고 입은 다시 닫힙니다.
  8. ⚠️ 캐릭터 역할 및 대화 무결성 (Speaker Identity & Role Integrity):
    • 한 캐릭터의 대화를 다른 캐릭터의 옷을 입은 캐릭터의 입을 통해 말하게 해서는 안 됩니다 (예: 직원의 말을 고객의 입을 통해 내보내는 것은 심각한 실수).
    • 어떤 씬에서 대화 캐릭터가 변경되면(주인 대 직원에서 고객 등장): 씬을 작은 샷으로 나누어(Camera Cut) 화면에 말하는 사람의 올바른 옷을 입은 캐릭터가 보이도록 해야 합니다.
  9. ⚠️ 신체 활동 및 한눈에 보는 액션 비트 (At-A-Glance Timed Action Beats):
    • 캐릭터를 로봇처럼 팔을 곧게 펴고 계속 서 있게 하거나, 어떤 활동도 전체 씬 동안 10~15초 동안 멈추게 해서는 안 됩니다.
    • 액션 및 소품은 관련 대화 시간에만 한눈에 (2.0~3.5초) 나타납니다 (characterPoses / secondaryPoses):
      • 장부 확인 (checking_khata): 계산 또는 장부 이야기 시 두 손으로 빨간 장부를 들고 보며, 눈은 아래를 봅니다. 대화가 끝나면 장부를 내리고 정상 자세로 돌아옵니다.
      • 재고 찾기 (searching_inventory): 찾는 대화 시간에 선반 쪽으로 손을 뻗어 돋보기와 빈 선반 태그가 보입니다. 말을 마치면 손을 내리고 정상적으로 말합니다.
      • 샘플 셔츠 들어올리기 (holding_shirt): 고객이 셔츠를 요청하는 순간 2~3초 동안 옷걸이에 셔츠를 들어 올려 보여준 후, 팔을 접고 기다립니다.
      • 참을성 없는 기다림 (arms_crossed): 가슴에 팔을 교차하여 서 있습니다.
  10. ⚠️ 쇼트폼 페이싱 및 카드 유지 제한 (Max 12-18s Card/Scene Retention Rule):
    • TikTok, YouTube Shorts 또는 Reels에서 단일 정적 모션 그래픽 또는 인포그래픽 카드를 20~40초 동안 계속 화면에 유지해서는 안 됩니다. 이는 극심한 시청자 이탈(Audience Drop-off / Retention Killer)을 유발합니다.
    • 긴 내레이션 또는 설명 텍스트(예: 이야기의 교훈 및 결말)는 자동으로 작은 시각적 비트로 분할해야 합니다:
      1. 캐릭터 감정적 해결 / 깨달음 애니메이션 씬 (12~15초): 주인공의 감정과 조용한 결말.
      2. 핵심 교훈 비교 카드 (15~18초): 빠르게 읽을 수 있는 핵심 포인트 비교.
      3. 시청자 상호작용 및 팔로우 CTA 카드 (10~12초): 시청자에게 직접 댓글 및 팔로우 요청.
    • 각 씬 및 카드는 최대 8~18초 내에 변경되어 새로운 시각적 자극을 생성해야 합니다.
  11. ⚠️ 활동 기반 비주얼 매핑 및 소품 (Activity-Driven Visual Storytelling & Literal Narrative Mapping):
    • 스크립트 또는 음성 해설에서 특정 신체 활동을 언급할 때 (예: "컴퓨터에서 눈을 떼지 않고 말했다", "책상에 앉아 일했다", "주인이 불렀다", "사직서를 제출했다", "항의했다"):
      • 씬에는 해당 활동과 적절한 소품이 반드시 시각적으로 포함되어야 합니다 (prop: "office_desk_computer" | "executive_desk" | "ceo_office_desk" | "resignation_letters" 및 캐릭터 포즈: using_computer | sitting_desk | pointing | reading_document | celebrating).
      • 캐릭터를 절대 빈 방에 로봇처럼 세워두어서는 안 됩니다. 설명에 컴퓨터나 책상이 언급되면 테이블에 앉아 모니터로 작업하는 관점을 표현해야 합니다.
  12. ⚠️ 씬 분할 및 빈번한 장면 전환 (Strict 4-10s Scene Granularity & Dynamic Perspective Rule):
    • 전체 이야기에서 단일 배경이나 프레임을 20~30초 동안 계속 유지해서는 안 됩니다. 음성 해설에서 주제나 분위기가 변경되면 시각적 장면도 반드시 컷(Cut)해야 합니다.
    • 각 씬은 최대 4~10초 길이여야 합니다.
    • 설명에서 시간 변화, 직위 전환 또는 장소 이동이 있을 때 (예: 평범한 직원 ➔ 항의 ➔ 모임 ➔ 관리자 승진 ➔ 경고장 ➔ 동료들의 두려움 ➔ 수민과의 갈등 ➔ 집단 사직 ➔ 사장실 ➔ 혼자만의 깨달음) 각각에 대해 별개의 시각적 씬, 프레임 및 관점을 보장해야 합니다.
  13. ⚠️ 유니버설 액션, 객체 및 좌석 매트릭스 (Universal Semantic Action-to-Prop & Seating Matrix):
    • 스크립트에서 어떤 주제나 환경을 언급하든, 캐릭터를 맹목적으로 서 있게 해서는 안 됩니다. 아래 매트릭스에 따라 자동 소품 및 좌석을 배치해야 합니다:
      씬 및 맥락자동 소품 (prop)좌석
      사무실/회의office_desk_computer, executive_desk, ceo_office_desksitting_desk
      카페/찻집coffee_cup, tea_glass, laptopsitting_chair
      병원/진료소stethoscope, clipboard, medical_chartsitting_chair
      교실whiteboard, textbook, pensitting_desk
      가게/시장product_box, cash_register, shopping_bagstanding (일반적으로)
      길거리/야외street_lamp, treestanding (일반적으로)
      집/거실sofa, tea_cup, remote_controlsitting_sofa
      결혼식장garland, flowerstanding (일반적으로)

4️⃣ 모드 2: 키네틱 모션 그래픽 & 프로모 엔진 규칙 (Mode 2 Guidelines)

  1. 브랜드 헤더 및 워터마크 (Persistent Brand Header & Watermark):
    • 모든 씬 상단에 브랜드 로고/텍스트 헤더가 지속적으로 표시됩니다.
    • 오른쪽 하단 모서리에 회색조 워터마크 로고가 표시됩니다.
  2. 도트 그리드 떠다니는 캔버스 (Dot-Grid Floating Canvas):
    • 배경에 부드럽게 움직이는 도트 그리드가 깔려 있습니다.
    • 드물게 마우스 커서 효과가 나타날 수 있습니다.
  3. 어두운 하단 캡션 필 + 네온 그린 (Dark Bottom Caption Pill + Neon Green):
    • 모든 구절/요점에 대해 어두운 배경의 캡슐 필이 사용됩니다.
    • 강조 단어는 네온 그린 (#22C55E)으로 표시됩니다.
  4. 스크립트 기반 맞춤형 벡터 자산 생성 (Script-Driven Bespoke Vector Asset Synthesis):
    • ⚠️ 기존 아이콘 재사용 금지: 각 주제에 대해 완전히 새로운 SVG 벡터 컴포넌트가 생성됩니다. 기존 라이브러리에서 관련 없는 아이콘을 가져오지 않습니다.
    • 엔진은 스크립트를 분석하여 키워드를 추출하고, 각 키워드에 대해 의미적으로 관련된 맞춤형 SVG 일러스트레이션을 절차적으로 생성합니다.
  5. 폰 목업 및 카드 메커닉 (Phone Mockup & Card Mechanics):
    • 필요시 폰 목업 화면에 앱 UI 또는 웹사이트 데모가 표시됩니다.
    • 정보 카드는 체계적으로 나타나고 사라집니다 (스택, 슬라이드, 페이드).
  6. 타이포그래피 및 모션 그래픽 규칙 (Typography & Motion Graphics Rules):
    • 굵고 현대적인 산세리프체 사용.
    • 텍스트 애니메이션: 나타나기, 슬라이드, 강조 표시.
    • 각 화면은 하나의 주요 메시지에 집중.

5️⃣ 품질 보증: 시각적 자기 점검 워크플로우 (Self-Check Visual Inspection)

렌더링 후 또는 미리보기 중에 다음을 검사합니다:

  • 중복 자막 확인: 말풍선/카드가 있을 때 하단 캡션 없음.
  • 입술 움직임 확인: 말하는 캐릭터만 입술 움직임.
  • 캐릭터 얼굴/의상 구분: 모든 캐릭터가 시각적으로 구별됨.
  • 소품/액션 일치: 언급된 모든 활동이 시각화됨.
  • 씬 길이 준수: 4~10초 규칙 위반 없음.
  • 카메라 흔들림 제한: 1.2초 초과 흔들림 없음.
  • 배경 일관성: 100% 풀스크린, 의미적으로 적절함.

6️⃣ 엄격한 승인 워크플로우 (Two-Point Approval Workflow)

  1. 첫 번째 승인 (컨셉 승인): AI Director Analyzer가 생성한 scripts/<story-name>-input.json의 내용을 검토합니다. 캐릭터 캐스팅, 배경 선택, 액션 비트가 스크립트와 일치하는지 확인합니다.
  2. 두 번째 승인 (렌더링 승인): 렌더링된 비디오를 검토하여 위의 품질 보증 항목을 통과했는지 확인합니다.

[!IMPORTANT] 두 승인 모두 완료되어야 최종 비디오로 간주됩니다. 어느 단계에서든 수정이 필요한 경우, 워크플로우를 처음부터 다시 시작해야 합니다.

관련 스킬