Communitygithub.com

스토리보드 디렉터

모든 비트가 텍스트, 위치, 시각적 요소, 움직임, 사운드, 타이밍 및 스크립트와의 연결을 기록하는 프로덕션 스토리보드를 제작합니다.

스토리보드 디렉터란 무엇인가요?

스토리보드 디렉터는 비디오 제작 파이프라인에서 정밀하고 일관된 스토리보드를 생성하는 AI 에이전트 스킬입니다. 이 스킬은 단순한 그림 나열을 넘어, 각 장면과 비트가 텍스트/내레이션, 시각적 요소, 위치/레이아웃, 모션, 사운드, 시간 등 모든 정보를 명확하게 기록하도록 강제합니다. 주요 플랫폼(클로드 코드, 커서 등)에서 사용 가능하며, 제공된 템플릿(STORYBOARD_TEMPLATE.md)을 기반으로 출력합니다. 워크플로는 브리프 확정, 스크립트 분할, 각 비트 상세 작성(위치, 프레이밍, 오디오, 비주얼 매핑), 연속성 검증 순으로 진행되며, 모든 텍스트는 그대로 기록하고 위치는 정규화된 좌표로 명시해야 합니다. 또한 60FPS 기준 정수 프레임 기반의 반개구간([startFrame, endFrame)) 규칙을 적용하고, 존재하지 않는 에셋은 PLACEHOLDER로 표시하며, 마지막에 맞춤형 엔드카드와 CTA를 필수로 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/HEAD/.claude/skills/storyboard-director

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

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

문서

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

필수 사항

스토리보드는 단순한 그림 목록이 아닙니다. 모든 장면과 비트는 텍스트/내레이션, 시각적 요소, 위치/레이아웃, 움직임, 사운드, 시간을 명시해야 합니다. 템플릿 docs/templates/STORYBOARD_TEMPLATE.md를 사용하세요.

워크플로

  1. 브리프, 1080×1920 세로 형식, 60 FPS, 지속 시간, 대상, 스타일 바이블, 주요 메시지를 확정합니다.
  2. 스크립트를 원자적 문장/비트로 나누고 안정적인 ID(S01-B01 등)를 부여합니다. 이유 없이 다른 문장을 병합하지 마십시오.
  3. 각 비트에 대해 정확한 VO 텍스트, 정확한 화면 내 텍스트, 보여지는 것, 주제/에셋, 동작을 작성합니다.
  4. 위치는 정규화된 0..1 좌표(x, y, w, h), 앵커, 정렬, 레이어/z-순서, 세이프 영역, 읽기 방향으로 설정합니다. 필요 시 픽셀 크기/위치를 포함합니다.
  5. 프레이밍, 카메라, 전환, 진입/퇴장 모션, 지속 시간, 시작/끝 프레임, 오버랩을 정의합니다.
  6. 오디오를 기록합니다: VO 클립, 음악, 앰비언스, SFX, 큐 프레임, 지속 시간, 상대 게인, 페이드, 일시 정지/무음.
  7. 각 VO 문장을 하나 이상의 시각적 요소/샷과 매칭하여 의미를 명확히 합니다. 반복적인 직역 시각 표현을 피하고, 은유가 더 효과적일 때는 이를 사용합니다.
  8. 연속성, 모바일 가독성, 세이프 영역, 타이밍, 총 지속 시간 일치 여부를 검증합니다.

비트별 필수 출력

  • ID, 장면, 시작/끝 프레임, 프레임 및 초 단위 지속 시간.
  • VO 문장 ID + 텍스트.
  • 화면 내 텍스트 + 위치.
  • 시각적 요소/에셋 + 구성 및 위치.
  • 모션/카메라 + 이징.
  • 오디오 큐: 유형, 파일/플레이스홀더, 시작/끝, 상대 레벨, 페이드.
  • 전환(in/out) 및 연속성 노트.

규칙

  • 모든 화면 내 텍스트는 그대로 기록해야 하며, "제목 추가"와 같이 적지 않습니다.
  • 모든 위치는 명시적이어야 하며, "대략 중앙에"와 같이 적지 않습니다.
  • 모든 사운드는 기록해야 하며, 소리 없음/무음 결정도 포함합니다.
  • 아직 존재하지 않는 에셋을 만들지 말고 PLACEHOLDER로 표시하고 에셋 요구 사항을 나열합니다.
  • 60 FPS에서 비트 지속 시간: durationInFrames = endFrame - startFrame (끝 경계는 제외).
  • 종료 로고 + CTA는 필수이며, 비디오에 특화되어야 하고 일반적이지 않아야 합니다.

ID 및 시간 규칙

  • 비트 ID: S<장면>-B<비트> (두 자리, 예: S01-B01). 비트가 이동해도 ID는 변경되지 않으며, 삽입된 비트는 새로운 ID(S02-B03)를 받고 전체 번호를 다시 매기지 않습니다.
  • 반개구간 [startFrame, endFrame): endFrame 프레임은 이미 다음 비트에 속합니다.
  • 초에서 프레임으로의 변환은 한 곳에서만 수행합니다: frame = round(seconds × fps). 그 후 스토리보드의 모든 숫자는 정수 프레임입니다.
  • 연속된 비트는 서로 이어져야 합니다: 비트 N의 endFrame = 비트 N+1의 startFrame. 오버랩은 전환 열에 기록된 전환 윈도우에서만 허용됩니다.
  • 총합: 마지막 비트의 endFrame = 컴포지션의 durationInFrames.

출력 형식

  • 헤더: 프로젝트 ID, 캔버스, FPS, 지속 시간(초 + 프레임), 스타일 바이블 및 오디오 플랜 경로.
  • docs/templates/STORYBOARD_TEMPLATE.md를 따르는 비트 테이블.
  • 복잡한 비트(다단계 모션, 캐릭터, 3D)에 대한 비트별 노트.
  • VO가 있는 경우 문장-샷 매핑, 그렇지 않은 경우 한 줄 "해당 없음 — VO 없음".
  • 오디오 큐 시트 (의도적 무음 포함).
  • 맞춤형 엔드카드 사양.
  • 요구 사항 및 라이선스 상태가 포함된 PLACEHOLDER 에셋 목록.

QA 체크리스트

  • 모든 비트에 ID, 프레임(in/out), 그대로의 텍스트(또는 "—"), 시각적 요소, 정규화된 위치, 모션, 사운드, 전환이 있는가?
  • 비트가 프레임 0부터 연속적이며, 지속 시간의 합이 durationInFrames와 일치하는가?
  • 중요한 텍스트가 세이프 영역 안에 있고, 휴대폰 화면에서 읽을 수 있는가?(크기, 대비, 화면 표시 시간)
  • 텍스트가 읽기에 충분한 시간 동안 화면에 머무르는가? 긴 문장은 분할하거나 더 많은 시간을 할당했는가?
  • 모든 VO 문장에 짝을 이루는 샷이 있고, 모든 샷에 편집 목적이 있는가?
  • 무음이 명시적으로 기록되었는가?(공백으로 남겨두지 않음)
  • 모션이 프레임의 함수로 설명되었는가?(from/to, 프레임 범위, 이징) — frame-time-engineering이 번역할 준비가 되어 있는가?
  • 엔드 카드가 비디오의 모티프를 이어가며 CTA가 그대로 기록되었는가?
  • 아직 존재하지 않는 모든 에셋이 PLACEHOLDER로 표시되었는가?

간단 예시

2초 텍스트 후크 비트:

| 비트 ID | 프레임 | VO | 화면 내 텍스트 | 시각적 요소 | 위치 | 모션 | 사운드 | 전환 | |:---|---:|:---|---:|---|---|---|---| | S01-B01 | 0–120 | — | 비디오가 왜 평범해 보일까요? | 어두운 단색 배경 | x .08, y .40, w .84; 왼쪽 정렬; z 2 | 각 단어가 10프레임 간격으로 진입, 위로 24px 슬라이드, 14프레임 지속, ease-out | 무음 0–30, SFX-001 휘파람 소리 30 | cut |

코딩 가능한 모션: 단어 i는 프레임 i × 10에서 시작; opacity 0→1 및 translateY 24→0 (범위 [i×10, i×10+14]).

실패 모드

  • "텍스트가 중앙에 나타남" → 코딩 불가; x/y/w/h, 앵커, 정렬을 작성.
  • 비트가 한 프레임 차이 (0–119 다음 120–240) → 배타적 규칙을 사용하지 않음; 모든 것을 반개구간으로 전환.
  • 코드에서 텍스트가 변경되었으나 스토리보드에는 반영되지 않음 → 스토리보드가 카피의 진실 공급원; 스토리보드를 먼저 업데이트.
  • 총 지속 시간이 컴포지션과 일치하지 않음 → 테이블에서 다시 계산; 코드에서 패치하지 않음.
  • 문장당 너무 직역적인 시각 표현 → 데모, 다이어그램, 은유 사용; 이유 기록.
  • 엔드 카드가 로고 + "팔로우" → 맞춤형 아님; 비디오 모티프에서 시각적 연결 구조 생성.

Individual skills in this repo

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

관련 스킬