Communitygithub.com

storyboard-reel

AI 에이전트가 핸드 드로잉 스토리보드, 로우 폴리 캐릭터 렌더링, 제품 이미지를 바탕으로 약 28초 분량의 9:16 광고 동영상을 제작할 수 있도록 가이드합니다. 로고, 브랜드 시트까지 포함된 완성된 결과물을 제공합니다.

storyboard-reel란 무엇인가요?

이 스킬은 AI 에이전트가 스토리보드 릴(storyboard reel)을 기획, 제작, 편집하는 전체 워크플로우를 안내합니다. 핵심 출력물은 로고와 간단한 브랜드 시트이며, 9:16 비율로 약 28초 길이의 나레이션과 자막이 없는 광고 영상을 만듭니다. Python 기반의 엔진(`python3 scripts/storyboard_reel.py`)을 사용하며, 다양한 샷 종류(로고, 돌리, 포즈, 클립, 글로우 등)를 지원합니다. 작업 흐름은 새 작업 생성부터 시작하여, 잡 JSON 편집, 컷아웃, 플레이트 생성, 연락처 시트 확인, 클립 생성, 프리뷰, 승인, 최종 렌더링, 업로드 순으로 진행됩니다. 음악과 음향 효과는 ElevenLabs나 직접 라이선스 트랙을 사용하며, VHS 효과와 같은 편집 옵션을 제공합니다. Cursor, Codex, Claude Code와 같은 AI 코딩 에이전트와 함께 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lokiverde/video-studio/tree/HEAD/skills/storyboard-reel

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

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

문서

스토리보드 릴(Storyboard Reel)

손으로 그린 스토리보드, 로우 폴리 캐릭터의 몇몇 렌더링, 그리고 제품을 사용하여 약 28초 길이의 9:16 광고를 음악과 음향 효과와 함께 만듭니다. 나레이션이나 캡션은 없습니다.

엔진: python3 scripts/storyboard_reel.py <command> <job>, 저장소 루트(scripts/ 폴더가 있는 폴더)에서 실행합니다. --help를 사용하면 모든 명령을 볼 수 있습니다. 로직은 scripts/sr_lib.py (샷 종류, 기본값, 타이밍, 검사), sr_shots.py (그리기), sr_matte.py (컷아웃), sr_media.py (ffmpeg, rembg, 미디어 서버)에 있습니다. Windows에서는 python3 대신 python을 사용합니다.

시작점: skills/storyboard-reel/job_template.json. new 명령이 이 템플릿을 작업 폴더로 복사합니다. 템플릿 샘플은 피겨-앤-글로우(figure-and-glow) 릴입니다. 카메라 우선(camera-first) 릴은 clip 샷으로 구성됩니다.

형식

  • 9:16, 약 28초. 음악 배경(music bed)이 길이를 결정합니다.
  • 엔진이 그리는 샷 종류: logo (검정 배경), black, dolly (피겨 방향으로 푸시 인), pose (홀드), clip (하나의 이미지-투-비디오 동작), glow (소품의 빛이 모여 폭발), white, shirt (흰 티셔츠 위에 디자인이 페이드 인, 아래에 제목), card (제목, 목업, 가격, 사이즈, 색상, 사이트), still (전체 프레임 키 이미지), scan (스코프를 통한 탐색).
  • 스토리보드에 따라 샷을 재정렬, 반복 또는 삭제합니다. 어떤 샷 종류로도 그릴 수 없는 패널이 있다면 sr_shots.py에 새 draw 함수와 테스트가 필요합니다. 그렇게 하기 전에 먼저 말씀해 주세요.
  • VHS 효과: job.json에 "vhs": 0.5 (0은 off, 1은 full). 캐릭터 구간에 적용되며 흰색 플래시를 지나면서 사라져서 셔츠와 카드가 깔끔하게 나옵니다. vhs가 켜져 있으면 주요 결과물은 final_9x16_vhs.mp4입니다.

입력

  • 스토리보드 페이지와 각 포즈의 피겨 렌더링이 들어 있는 폴더입니다. 파일 이름에 logo, mockup 또는 board가 포함되어 있으면 자동으로 인식됩니다. 가능하다면 흰 배경의 로고와 제품 목업도 추가하세요.
  • 제품 페이지 URL. new 명령이 해당 페이지의 Shopify .json 파일에서 제목, 가격, 사이즈, 색상을 읽어옵니다.
  • 공개(reveal)를 위해 평범한 밝은 배경의 뒷면 프린트 사진이 필요합니다. 설정되지 않은 경우, 첫 번째 상점 이미지가 사용됩니다. 종종 복잡한 목업이므로 깔끔한 이미지로 교체하세요.

워크플로우

  1. 새 작업. python3 scripts/storyboard_reel.py new <product-url> <images-folder> [--word <topic>] [--title "<title>"] 이미지를 src/ 폴더로, 상점 이미지를 product/ 폴더로 복사하고 카드 카피를 채웁니다. --word는 작업 폴더 이름 끝에 주제어를 추가합니다.
  2. 스토리보드에 따라 job.json 작성. 각 패널을 하나의 샷에 매핑하고, panel을 스토리보드와 일치시키고, 각 렌더링을 피겨에 할당한 다음, 플레이트 프롬프트를 작성합니다. python3 scripts/storyboard_reel.py check <job> 명령이 타임라인을 문제없이 출력하면 완료입니다.
  3. 컷아웃 (피겨 릴): cutouts <job> 실행 후 work/cut/feet_check.jpg를 엽니다. rembg는 옅은 뼈를 옅은 바닥에서 떨어뜨리면서 캐스트 섀도를 유지할 수 있습니다. 각 발은 figures.<name>.feet 상자(소스 픽셀 단위)로 수정합니다 (add는 옅은 픽셀을 복원하고, drop은 어두운 바닥 그림자를 지우며, rebuild는 상자를 다시 유도합니다). 모든 발이 온전해질 때까지 다시 실행합니다.
  4. 플레이트. plate <job> --n 3 명령이 미디어 서버(무료)에서 배경 후보를 만듭니다. work/bg/plates.jpg를 보고 적합한 plate.src를 선택하세요. 프롬프트에 "전경에 넓고 텅 빈 평평한 바닥"을 유지하세요. 피겨가 look.feet_y에 서 있기 때문입니다. 직접 이미지를 plate.src로 설정할 수도 있습니다.
  5. 연락처 시트, 첫 번째 게이트. stills <job> 명령이 work/contact_sheet_9x16.jpg를 생성합니다. 발이 바닥에 닿고, 피겨가 하단 UI 스트립을 벗어나며, 카드 카피가 올바른지 확인하세요. 사용자에게 시트와 클립의 견적 비용을 보여줍니다. 멈추고 기다리세요.
  6. 클립, 사용자의 승인 후에만. kling-frames <job> 명령이 work/kling/<shot>_start.jpg (클립에 끝 프레임이 있는 경우 _end.jpg도 함께)를 생성하고 각 프롬프트를 출력합니다. 프레임을 이미지-투-비디오 서비스(OpenArt: 업로드, openart_model_cost로 견적, 생성)에 업로드하고 ~/video-studio/relay/auth.md 파일의 AUTH 라인 아래에 기록합니다. 다운로드 파일을 저장한 후 prep-clip <job> <download.mp4> --shot <id>를 실행합니다. 클립의 길이가 해당 샷의 길이를 결정합니다.
  7. 프리뷰, 두 번째 게이트. preview <job> 명령이 클립 스트레치와 사운드를 결합하여 work/preview_clip.mp4를 렌더링합니다. 모션을 프레임별로 확인하고, stills를 다시 실행한 후 사용자에게 프리뷰와 새 시트를 보여줍니다. 멈추고 기다리세요.
  8. 포스트 카피. job.json의 post를 작성합니다: 짧은 caption, 그 다음 instagram, tiktok, youtube (제목과 설명), facebook, hooks, order, cover 노트. 엔진이 모든 캡션 아래에 sr_post.py의 고정 서명 블록을 추가합니다. 해당 블록을 브랜드에 맞게 편집하세요. kit <job> 명령이 "post copy not ready" 줄을 출력하지 않으면 완료됩니다.
  9. 승인 및 렌더링. 사용자 승인 후: approve <job>, 그 다음 render <job>. 이 명령은 out/final_9x16_vhs.mp4 (테이프 컷, 더 느림), out/cover.jpg, out/post.txt, out/posts.md를 생성합니다. 그런 다음 render <job> --clean 명령으로 깔끔한 out/final_9x16.mp4를 만듭니다. 모든 렌더링은 _nomusic 쌍도 생성합니다(음향 효과만, 음악 배경 없음). 기록된 1080x1920 30/1 <length>s, audio 줄을 확인한 후, 컷 부분에서 프레임을 추출합니다. --out <path>는 out/ 폴더와 작업 상태를 건드리지 않는 사이드 렌더링을 만듭니다.
  10. 업로드. upload <job> 명령이 최종본, 쌍, 커버, 포스트 키트를 CDN 스토리지(BunnyCDN, 키는 config.env에 있음)로 보냅니다. 포스트 카피에 빈 캡션이나 남아 있는 <placeholders>가 있으면 업로드를 거부합니다. 재업로드는 새 이름(_v2)으로 이루어집니다. CDN은 재사용된 경로에서 계속 이전 파일을 제공하기 때문입니다. 사용자에게 새 URL을 제공하고 posts.md에서 플랫폼별 캡션을 붙여넣습니다. 게시는 사용자의 단계입니다.

프리뷰 게이트 (코드로 강제)

render는 approve가 있을 때까지 차단되며, approve는 현재 작업에서 만든 시트에 대해서만 작동합니다. 그림의 모든 변경 사항은 승인을 무효화합니다: 샷, 피겨, 플레이트, 룩, 컷아웃, 새 클립, 또는 job.json의 시각적 부분에 있는 모든 경로. 오디오와 포스트 카피 편집은 무효화하지 않습니다. 그림 변경 후에는 새 시트를 만들어 다시 보여주세요. render --no-preview는 사용자가 해당 작업에 대해 명시적으로 면제한 경우에만 사용됩니다.

카메라 우선 모션

모션 샷은 카메라 우선 이미지-투-비디오 클립으로, 실제 푸티지 샷처럼 작성됩니다: 카메라 리그와 렌즈, "줌이 아니고 컷이 아닌" 하나의 카메라 움직임, 그 다음 액션. 낮은 해상도 계층부터 시작하세요. 느린 줌으로 홀드된 스틸은 슬라이드쇼처럼 보입니다.

  • 시작 프레임만: 카메라는 자유롭습니다(돌리, 아크, 어드밴스).
  • 포즈에 정확히 도달해야 하는 푸시: 끝 프레임(약 1.12x로 끝 포즈를 크롭한 것)을 추가하세요. 그러면 푸시가 정확히 그곳에 도달합니다. 시작-전용 클로즈업은 머리를 스냅할 수 있습니다.
  • 정지 클립(start와 end 이미지 경로가 있는 clip)은 src가 시작 프레임인 정지 샷 다음에 와야 합니다.
  • "in": 1.0은 클립의 첫 1초를 건너뜁니다. dur: "clip"은 클립의 실제 길이를 사용하며, fill 샷이 차이를 흡수합니다.
  • "gain"은 클립을 어둡게 합니다. "lights_out": {"at": 2.8, "flicker": 0.7, "floor": 0.04}는 빛을 떨리게 하고 거의 검은색으로 떨어뜨리며, 편집에서 무료로 처리됩니다. 일치하는 음향 효과와 함께 사용하세요.
  • 위협은 화면 밖에 유지하세요. 어둡고 보이지 않는 것이 화면 안의 생물보다 더 무섭게 읽힙니다.
  • 총격은 화면에 보이지 않게 하세요: 검은 화면으로 자르고 소리가 전달하게 하세요. 모델은 지시를 받아도 무기를 발사하므로, 무기 클립을 프레임별로 확인하고 어떤 총격도 일어나기 전에 샷을 끝내세요.
  • 비디오 모델을 위한 프롬프트 작성법:
    • 하나의 느리고 연속적인 움직임. 무엇이 정지해 있는지 말하세요(몸, 발, 배경).
    • 소품이 어떻게 행동하는지 말하세요("지팡이는 똑바로 유지되고 절대 흔들리지 않음"). "흔들림"은 피하세요.
    • 나타나야 할 것을 설명하세요. 부정("안개 없음")은 종종 무시되므로, 덜 보여주세요.
    • 소품이 움직일 때, 몸 전체가 함께 움직입니다: 체중, 몸통, 머리. 발은 고정.
    • 클로즈업은 대부분의 클립 동안 느린 호흡과 작은 기울기가 필요하고, 그 다음 한 번의 빠른 움직임이 필요합니다. 그렇지 않으면 얼어붙은 것처럼 보입니다.
  • 클립 길이: 3~5초. 더 긴 클립은 모델이 벗어날 여유를 줍니다.

편집 측 노브 (무료, 편집에서 그림)

  • "fade_in"은 클립을 검은색에서 페이드 인합니다. "flash"는 그 안에 흰색 플래시 컷을 추가합니다.
  • "handheld" (0~1)은 홀드된 스틸을 흔듭니다. 카메라 클립(자체 카메라가 있음)에는 0을 사용하세요.
  • scan은 넓은 스틸 위에서 스코프를 통한 탐색으로, 자체 샷입니다. 비디오 모델 팬을 사용하지 마세요. 팬은 슬라이더처럼 미끄러지기 때문입니다: {"kind": "scan", "dur": 4.4, "src": "<wide still>", "span": 0.236, "scope": {"radius": 0.445, "sway": 16, "steady": 2.4}, "path": [[0.0, 0.13, 0.24], [3.2, 0.645, 0.345]]} 각 경로 점은 [초, x, y] (스틸 위)입니다. 조준점은 스프링처럼 경로를 따라가므로, 오버슛하고, 수정하고, 마지막 점에 도달합니다. 비디오 모델에 "원 없음, 십자선 없음"이라고 말하세요. 클립이 스코프를 통해 보여지는 경우 편집에서 링을 그립니다.
  • "live"를 스캔에 사용하면 스틸 안에서 주어진 초부터 넓은 클립을 재생하여, 렌즈가 대상을 찾았을 때 실제 속도로 움직입니다. 일시 중지를 제거하는 데 사용하세요.
  • 모델이 만들지 못할 작은 기계적 움직임(방아쇠, 스위치): 키 프레임에서 편집으로 리깅하세요. 움직이는 부분을 다각형으로 자르고, 뒤를 채우고, 한 번의 느린 푸시로 관절을 돌리세요. 움직임이 화면을 채우도록 크롭하세요.
  • shirt "from_black": 1.0, "from_white": 0은 스토리보드에 화이트아웃이 없을 때 검은색에서 공개를 페이드 인합니다.

전체 프레임 스틸 및 키 프레임

피겨 렌더링이 없거나, 스토리보드에 클로즈업이나 시점 샷이 있을 때 사용하세요.

  • still 샷은 전체 프레임 이미지 src를 사용하며, push, anchor [x, y], fade_in, fade_out, flash 옵션이 있습니다.
  • 키 프레임은 이미지 편집 모델에서 9:16으로 생성됩니다. 캐릭터 시트와 장면을 참조로 제공하되, 시트를 먼저 제공하세요. 테스트된 한 설정에서는 처음 두 참조만 모델에 도달했으므로, 중요한 것을 먼저 유지하세요.
  • 클립의 끝 프레임은 시작 프레임의 편집본입니다("같은 이미지, 단지 ..."). 따라서 두 프레임이 정렬됩니다. 작은 변경은 모델 편집보다 코드에서 로컬 편집으로 하는 것이 더 빠릅니다.
  • 클로즈업은 시트의 자체 뷰와 일치합니다: 측면 샷은 시트의 진정한 프로필입니다.
  • 프로필의 두개골은 실제 비율을 유지합니다(짧은 얼굴 위의 둥근 두개). 후드는 두개골을 따라가며 위와 뒤를 덮습니다. 프롬프트에 그렇게 말하세요.
  • 머리 장식은 측면 윤곽선으로 판단하세요. 윤곽선을 설명하세요("짧고, 둥글고, 머리 뒤에서 끝남"). "키가 크다" 또는 "뾰족하다"와 같은 단어는 이미지 모델이 마법사 모자를 만들게 합니다.
  • 손은 두개골 높이만큼 깁니다. 뼈 손의 경우 개별 손가락 뼈의 이름을 지정하세요. "두껍고 덩어리진"만으로는 주먹이 됩니다.
  • 오프닝 샷은 전체 세트 위에서 높고 넓게 시작한 다음, 아래로 내려와 피겨에 도달합니다. 먼저 넓은 프레임을 만들고 그 크롭으로 클로즈업 끝 프레임을 가져오세요. "카메라가 움직였다"고 말하는 편집은 대신 제자리에서 피겨를 확대하는 경향이 있습니다.

먼저 무료 드래프트 보드

유료 호출 전에, 모든 패널을 미디어 서버(FLUX, 각각 약 8초)로 work/keys/에 러프하게 만든 다음 stills를 실행하세요. 사용자는 무료로 전체 컷을 봅니다. 러프는 캐릭터를 고정하지 않으므로, 보여줄 때 그렇게 말하세요. 유료 키 프레임이 러프를 대체합니다. 새 캐릭터의 경우 캐릭터 시트가 첫 번째 유료 호출입니다. 그런 다음 모든 키 프레임은 해당 시트를 첫 번째 참조로 사용합니다.

캐릭터당 하나의 화면 방향을 유지하세요(잘못된 방향이면 러프를 미러링하세요). 재등장하는 캐릭터는 실제 키 프레임에서 잘라내며, 러프에서는 절대 잘라내지 않습니다.

각 재등장 캐릭터를 assets/characters/<name>/에 README와 함께 유지하세요: 시트, 의상 규칙, 사용하는 세트. 키 프레임 전에 README를 읽으세요.

음악 및 사운드

  • 음악 배경: 약 30초의 기악곡, check가 출력하는 타임라인에 맞춰 작성됩니다. 일반적인 구성: 로고에서 히트, 돌리 아래에서 음침한 배경, 클립과 글로우를 통해 상승 빌드, 화이트아웃에서 드롭, 카드에서 마지막 히트. ElevenLabs 음악으로 생성하거나 직접 라이선스 트랙을 사용하세요. assets/music/<name>.mp3에 저장하고 프롬프트를 audio.prompt에 넣으세요.
  • 사운드 효과는 assets/sfx/에 있습니다(임팩트, 우쉬, 라이저). 샷에 고정된 audio.sfx 항목을 추가하세요. 소품이 바뀌면 새 항목을 만드세요.
  • audio.mute: [<shot ids>]는 해당 샷 전반에 걸쳐 음악을 완전히 자르고 사운드 효과만 재생합니다. "검은 화면으로 자르고 총격"에 사용하세요.
  • 생성된 총격 폭발은 하나의 소음 벽으로 번집니다. 하나의 깔끔한 총을 생성하고 폭발을 로컬로 레이어링하세요: 로우 쉘프, 각 히트 아래에 피치가 떨어지는 서브 덤프, 히트당 작은 피치 및 레벨 변화, 그 다음 리미터.

비용

플레이트, 컷아웃, 로컬 렌더링은 무료입니다. 유료 키 프레임, 클립(OpenArt 또는 유사), ElevenLabs 음악 및 사운드 효과는 크레딧이 소모됩니다. 각 호출에 대해 먼저 견적을 내고, ~/video-studio/relay/auth.md의 AUTH 라인을 유지하세요.

job.json 간략 설명

length (음악 컷 포인트), product (url, 제목, 가격, 사이즈, 색상), plate (src, prompt), figures (이름에서 src, 선택적 feet, centre_on), shots (id, kind, dur, panel 및 종류별 키 목록), vhs, handheld, audio (music, prompt, music_gain, fade_out, mute, sfx), post (플랫폼별 카피), 선택적 look. 종류별 기본값은 sr_lib.py의 SHOT_DEFAULTS에 있습니다. 화면상의 카피는 {title}, {details}, {site}를 받습니다.

주의사항

  • 컷아웃에 rembg가 필요합니다: pip install rembg. cutouts 명령이 무엇이 누락되었는지와 설정 방법을 알려줍니다.
  • 글로우는 마젠타색 구를 색상으로 찾습니다. 다른 소품의 경우 light.at ([x, y, r], 피겨 박스의 분수)와 light.rgb를 설정하세요. 가격과 사이즈를 라이브 페이지와 확인하세요.
  • ffmpeg가 PATH에 있어야 합니다. 모든 화면상 텍스트는 Pillow로 그려지므로 ffmpeg에 drawtext 필터가 필요하지 않습니다.

Individual skills in this repo

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

관련 스킬