Communitygithub.com

3D-비디오-스튜디오

일상적인 발명품의 가짜 탄생 스토리를 담은 약 60초 분량의 코미디 세로형 숏폼을 제작합니다. 예를 들어 '운전자들이 왜 길을 찍기 시작했는가' → '그게 바로 대시캠이 발명된 이유입니다'와 같은 형식입니다.

3D-비디오-스튜디오란 무엇인가요?

이 스킬은 사용자가 입력한 주제를 바탕으로 약 60초 분량의 코미디 세로형 숏폼(YouTube Shorts, Instagram Reels, TikTok 등에 적합)을 자동으로 제작하는 AI 에이전트 스킬입니다. 주로 '왜 X가 발명되었는가' 또는 '그게 바로 X가 발명된 이유입니다'라는 포맷으로, 어떤 교활한 인물이 허점을 이용해 사건을 확대시키고 결국 조용한 피해자가 그 발명품을 사용해 제압하는 스토리를 따릅니다. 시각적으로는 평면 얼굴의 만화 캐릭터가 glossy한 3D 세계에서 움직이며, 3가지 색상의 막(act)으로 구성되고 1-2단어 캡션이 포함됩니다. 모든 장면과 전환은 코드로 렌더링되며, 대사는 사용자가 Cartesia 서비스를 이용해 태그된 스크립트로 음성 파일을 생성하여 제공합니다. 이 스킬은 사용자가 `/3d-video-studio` 명령을 실행하거나, 참고 영상과 같은 3D 만화 숏폼 제작을 요청하거나, '왜 X가 발명되었는가' 형식의 숏폼을 요청할 때 활성화됩니다. Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트에서 실행 가능하며, Node.js 18+, ffmpeg, Python 3.9+ 환경이 필요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/codewithsiddique-04/3d-video-studio/tree/HEAD

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

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

문서

/3d-video-studio

┌──────────────────────┐
│  "Why Drivers Started│  제목은 행동에 대해 묻고, 발명품 이름은 언급하지 않음
│   Filming The Road"  │
│   ◕‿◕  ▶ 💥           │  훅: 사기꾼의 악행, 4초 안에 페이오프
│   loophole → greed   │  확대, 무표정한 반박, 두 번의 "하지만" 반전
│   quiet guy points ▣ │  발명품 자체의 시점을 통해 공개
│ "that's how the ___  │  태그가 제목에 답하고, 마지막 장면이 첫 장면으로 루프됨
│   was invented."     │
└──────────────────────┘

단계를 순서대로 진행하세요. ⏸ 는 게이트를 의미합니다: 멈추고, 결과를 보여주고, 사용자의 답변을 기다리세요. 각 게이트에서 다음 단계가 무엇인지 말하세요. 현재 단계에 나열된 파일만 읽으세요.

SKILL_DIR="<base directory of this skill>"; ENGINE="$SKILL_DIR/engine"
KIT="$SKILL_DIR/kit"; [ -d "$KIT/node_modules/playwright" ] || KIT="$HOME/.claude/kit"
PY="$KIT/.venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$KIT/.venv/bin/python"
[ -d "$ENGINE/node_modules/three" ] && [ -x "$PY" ] || bash "$SKILL_DIR/setup.sh"

Node 18+, ffmpeg 및 Python 3.9+가 필요합니다. bash "$SKILL_DIR/setup.sh"가 나머지 (three.js, Playwright + Chromium, Parakeet 단어 타이밍 모델이 포함된 Python 가상 환경)를 한 번 설치합니다. 아래의 모든 Python 도구는 "$PY"로 실행하세요.

참조 프로필은 모든 게이트의 기준입니다.

  • PROFILE="$SKILL_DIR/story/examples/dashcam"에는 측정된 숫자(profile.json), 각 설정의 프레임(frames/) 및 각 전환의 모든 프레임(transitions/)이 있습니다.
  • 사용자가 새 참조를 가져오면 먼저 해당 프로필을 구축하고("아래 새 참조에서 학습") PROFILE을 가리키도록 하세요.
  • 프레임은 공개 저장소에 포함되지 않습니다. story/examples/dashcam/ 및 story/examples/cashier/에는 측정된 숫자(profile.json)와 작성된 비트 시트가 있지만 참조의 프레임은 없습니다(원래 채널에 속함). $PROFILE/frames가 없으면 사용자에게 참조 비디오를 요청하고(이 형식의 모든 숏폼이 작동함) "아래 새 참조에서 학습"의 2단계를 $PROFILE을 출력 폴더로 하여 4단계 전에 실행하세요. 사용자에게 참조 비디오가 없으면 profile.json과 작성된 예제만으로 판단하고 각 게이트에서 그렇게 말하세요.
  • 절대 우리 프레임만으로 판단하지 마세요: 모든 검토 시트에는 참조를 우리 것 옆에 놓습니다.

1단계 · 주제 ⏸

story/topic-bank.md를 읽으세요. 사용자의 주제를 사용하거나 세 가지를 제안하세요. 4가지 질문 테스트를 실행하고 가장 약한 체크 항목을 말하세요. 게이트: 사용자가 주제를 선택합니다.

2단계 · 제목 및 스크립트 ⏸

story/title-formula.md, story/formula.md, story/hook-rules.md, story/script-template.md, story/script-check.md를 읽으세요. 또한 story/rig-check.md(평면 캐릭터가 할 수 있는 것과 없는 것)를 읽고 "$PY" "$SKILL_DIR/tools/rig_check.py" <project>/script.json을 실행하여 점수를 매기기 전에 모든 플래그를 "Stage it as" 메모와 함께 표시하세요. 릭이 보여줄 수 없는 대사는 음성 녹음 전에 수정되어야 합니다. 먼저 제목을 쓰고, 그 다음 비트별로 스크립트를 작성하세요. 점수를 매기세요(9/10 미만은 다시 작성). 제목, 스크립트(한 줄에 한 문장, 비트 레이블은 옆에), 단어 수, 3.8단어/초로 추정한 길이 및 점수를 표시하세요. 게이트: 사용자가 승인하거나 편집합니다. 승인된 문장을 <project>/script.json으로 저장하세요(먼저 cp -r "$ENGINE/template" <project>로 프로젝트를 생성하세요; <project>는 존재하지 않아야 합니다).

3단계 · 비주얼 바이블 ⏸

look/style-guide.md(하우스 룩: 광택 있는 래커 표면, 초점이 맞는 모든 것에 잉크, 자연 채광, 약간 흐릿한 배경, 빽빽한 장식) 및 look/visual-bible.md(규칙 및 템플릿)를 읽으세요. 먼저 룩을 생성하세요: node "$ENGINE/cast.mjs" new <project> --chars <roles> --cars <roles>. 그런 다음 <project>/visual_bible.md를 작성하여 다음을 포함하세요:

  • 모든 캐릭터(체형, 머리와 헤어, 16진수 색상 코드의 의상 레이어, 액세서리, 스토리에 필요한 얼굴 표정);
  • 모든 환경(레이아웃, 표면, 보이는 광원, 벽당 4~8개의 드레싱 아이템, 정확한 텍스트 개그, 깊이);
  • 인테리어(자동차, 부스, 스크린), 소품(주인공 발명품 전체) 및 2D 그래픽;
  • 각 항목을 library + params, library + new text 또는 new로 표시하는 에셋 계획. 캐스트 출력과 함께 바이블을 보여주세요. 게이트: 사용자가 승인, 편집 또는 재생성을 요청합니다.

4단계 · 룩 시트 ⏸

스토리보드 전에 최종 디테일로 3D로 구축된 비주얼 디자인을 보여주세요. look/setup-types.md를 읽으세요.

  • lookdev.html, lookdev.js 및 sets.js는 템플릿과 함께 제공됩니다. 스토리에서 가장 분주한 셋을 sets.js에 작성하세요(heroSet()은 하우스 룩의 예제입니다: 교체하고 레이어는 유지하세요). 바이블을 정확히 따라야 합니다. 비디오는 나중에 동일한 sets.js를 가져오므로 이 작업은 버려지지 않습니다.
  • lookdev.js는 이미 카드를 만듭니다:
    • 모든 cast.json 캐릭터, 라벨이 있는 3명씩 줄지어;
    • 주인공의 얼굴 표정;
    • 히어로 셋: 와이드, 렌즈 블러 10의 미디엄, 블러 14의 소품 클로즈업;
    • 히어로 자동차. 히어로 소품에 대한 카드와 바이블이 new로 표시한 다른 모든 셋에 대한 카드를 추가하세요.
  • 스토리가 사용하는 설정 유형당 하나의 카드(interior, pov, tracking, house, twoshot, talker, device), 각각 실제 셋과 실제 프레이밍으로 구축하고 look/setup-types.md의 모든 "Must have"를 포함합니다. 대시보드 POV, 토커 벽 및 디바이스 뷰는 건너뛰기 쉬운 것들입니다; 지금 구축하세요.
  • 참조와 쌍을 이루세요: "$PY" "$SKILL_DIR/tools/sbs_sheet.py" <project>/review/look_pairs.jpg --ours <cards> --ref <$PROFILE/frames에서 동일한 유형>.
  • 1:1 비율의 400px 크롭 스트립 하나를 추가하세요(게이지, 벽 개그, 차체, 도로). 누락된 디테일과 블러가 드러납니다.
  • node "$ENGINE/film.mjs" check <project> 0 <cards> 0.5 --page lookdev.html을 실행하고 모든 FAIL을 수정하세요(clipped-art 포함: 캐릭터의 머리카락, 모자 또는 머리 아트가 가장자리에서 평평하게 잘린 경우). 그런 다음 node "$ENGINE/film.mjs" sheet <project> <project>/review/look.jpg 0.5 1.5 2.5 ... --page lookdev.html --w 360 --cols 4를 실행하세요.
  • 코드로 점수를 매기세요: node "$ENGINE/film.mjs" lookcheck <project> <project>/review/lookcheck 0.5 1.5 ... --page lookdev.html (광택, 윤곽선, 빛, 깊이, 밀도, 색상, 얼굴; look/targets.json에 대해 0~10). 모든 LOW를 수정한 다음, 숫자로 판단할 수 없는 것(스토리 소품, 매력)을 위해 시트를 한 번 눈으로 확인하세요. 점수를 시트와 함께 표시하세요. 8단계에서 각 막의 프레임에 대해서도 lookcheck를 실행하세요. review/look.jpg 및 review/look_pairs.jpg를 전달하세요. 게이트: 사용자가 캐릭터, 세계 및 모든 설정 유형의 룩을 승인하거나 수정 목록을 제시합니다. 비디오의 모든 셋은 이 수준의 디테일로 구축됩니다.

5단계 · 스토리보드 + 음성 스크립트 ⏸

한 번에 두 개의 문서:

  1. 스토리보드 <project>/storyboard.md: 카메라 설정당 한 행(18~21개): # | sentence(s) | beat | setup type | camera move | action and faces | prop gag | transition in (frames) | act/mood. story/formula.md("Picture and edit")의 규칙; story/examples/dashcam.md는 전체 예시를 보여줍니다.
    • 설정 유형은 look/setup-types.md의 이름 중 하나이며, 코드에서 샷의 type이 됩니다.
    • 액션 및 표정은 엔진 포즈(stand, walk, sitOn, point, lean, armTo…) 또는 모든 액션에 대한 소품을 지정합니다; 그 외의 것은 story/rig-check.md에서 실패하므로 구축 전에 다시 작성합니다.
    • 카메라 이동: 모든 행은 이동과 속도를 지정합니다(예: "push-in 6%/s", "pull-back to wide", "orbit 120°"); 디바이스 뷰만 "locked"를 사용할 수 있습니다.
    • 전환 진입: 디졸브는 7~10프레임(공개 장면의 경우 최대 16프레임)이거나 인월드 전환의 이름을 지정합니다. 셋, 캐릭터 및 소품은 승인된 비주얼 바이블에서 가져옵니다: 바이블에서 사용한 대로 이름을 지정하세요. 표 아래에, 스토리보드가 추가한 모든 항목과 함께 바이블의 에셋 계획을 복사하세요.
    • 연속성 표(스토리보드 아래): 장소나 상태가 변경되는 모든 소품 또는 캐릭터는 한 줄을 가집니다: thing: state → state → state, 각 변경의 설정 번호 포함(예: key: pocket (1) → floor (3) → dog's mouth (5)).
      • 모든 변경은 화면에서 명명된 설정에서 발생하거나, 시청자가 읽을 수 있는 화면 액션(던지기, 착지, 건네주기 등)으로 표시됩니다.
      • 어떤 설정도 시청자가 본 적 없는 상태에서 시작할 수 없습니다. 보이지 않는 변경에 의존하는 이후 액션(아무도 떨어뜨리는 것을 보지 못한 것을 찾는 것)은 스토리보드 실패입니다: 설정에 액션을 추가하거나 설정을 추가하세요. 나레이션된 시간 점프를 가로질러, 일반적인 오프스크린 단계는 허용됩니다(숨긴 곳에서 티켓을 꺼내는 것).
      • 각 소품에 스토리 오브젝트(플롯과 함께 이동) 또는 개그 소품(숨는 곳, 용기 또는 농담 대상으로 자체 비트에 머뭄) 레이블을 지정하세요. 새 위치의 개그 소품은 나레이션이 그곳에서 이름을 지정하지 않으면 실패합니다.
      • 표 아래에, 위치당 하나의 운반 라인: 누가 거기 있는지, 각자가 무엇을 가지고 있고 왜 그런지.
    • 현실 점검(story/rig-check.md, 마지막 섹션): 모든 액션과 운반된 아이템은 실제 사람이 그 순간에 가질 이유가 있어야 합니다. 유일한 이유가 연속성이라면 행을 다시 작성하세요.
  2. 음성 스크립트 <project>/voice/cartesia.md: story/voice-cartesia.md를 읽고 태그된 블록(블록당 감정, 속도 조언, "하지만" 반전과 태그 앞에서만 일시 정지)을 작성하세요.

둘 다 보여주세요. 게이트: 사용자가 스토리보드를 승인합니다. 그런 다음 음성을 요청하세요: "Cartesia에서 voice/cartesia.md의 블록을 생성하고 파일을 <project>/audio/에 넣으세요(vo_01.wav, vo_02.wav... 또는 하나의 vo.wav). 그동안 5초 미리보기를 빌드하겠습니다." 오디오를 기다리지 않고 6단계로 계속 진행하세요.

6단계 · 5초 미리보기 ⏸

훅(처음 5초, 일반적으로 설정 1~3)만 빌드하여 사용자가 긴 빌드 전에 룩을 판단할 수 있도록 합니다. engine/API.md를 읽고; engine/template/video.js에서 블록을 복사하세요(engine/src는 열지 마세요). cast.json에서 모든 캐릭터와 자동차를 빌드하고(makeChar(CAST.characters.x), buildCar(CAST.cars.x)), stand/sit 포즈를 사용하세요.

  • 타이밍: sentenceStarts / captionsFromWords와 추정(estimateWords)을 사용하거나, 오디오가 이미 도착한 경우 실제 단어 파일을 사용합니다(7단계).
  • ./sets.js에서 셋을 가져오고 makeStage({ mood: withLook(mood, 'indoor' | 'outdoor') })를 사용하세요.
  • 판단 기준이 되는 룩은 승인된 룩 시트입니다: 광택 있는 표면의 깔끔한 3D, 초점이 맞는 모든 것에 잉크, 자연 채광, 약간 흐릿한 배경, 가장자리부터 가장자리까지 채워진 모든 프레임. 얼굴이 비어 있거나 머리 뒤쪽만 보이면 포즈 후에 카메라가 배치된 것입니다(engine/API.md, chars.js 참조).
  • 모든 얼굴에 mark를, 모든 샷에 type을 지정하세요. node "$ENGINE/film.mjs" check <project> 0 5 0.25를 실행하세요; FAIL이 있으면 종료 코드 1을 반환하므로 모두 수정하세요.
  • 하나의 시트: node "$ENGINE/film.mjs" sheet <project> <project>/review/preview.jpg 0.2 0.8 1.6 2.6 3.6 4.6 --w 180 --cols 6. 한 번 보고 명백히 잘못된 것을 수정하세요.
  • 렌더링: node "$ENGINE/film.mjs" render <project> <project>/review/preview.mp4 0 5 (약 1분). 음성이 있으면 처음 5초를 추가하세요: ffmpeg -i review/preview.mp4 -i audio/vo.wav -map 0:v -map 1:a -c:v copy -t 5 review/preview_vo.mp4.
  • 훅을 참조의 훅과 비교하세요:
    • "$PY" "$SKILL_DIR/tools/compare_video.py" <project>/review/preview.mp4 "$PROFILE" <project>/review/cmp_preview --range 0 5;
    • 우리의 플라이아웃 스트립을 $PROFILE/transitions/ 옆에 놓으세요(플라이아웃은 약 4프레임 안에 유리를 통과하고 와이드 샷에 착지합니다). 미리보기를 보여주기 전에 움직임, 선명도 및 디테일의 FAIL을 수정하세요. mp4 경로와 쌍 시트를 전달하세요. 게이트: 사용자가 룩(캐릭터, 색상, 카메라, 캡션)을 승인하거나 변경을 요청합니다. 캐릭터나 스타일 변경은 여기서는 저렴하지만 나중에는 비쌉니다.

7단계 · 음성 입력

사용자가 오디오가 <project>/audio/에 있다고 말하면: story/voice-cartesia.md의 "When the audio arrives"를 따르세요(블록 결합, words.py, 길이와 속도 확인).

  • 속도는 엄격한 게이트입니다: 초당 3.5~4.1 단어를 벗어나면(film.mjs check가 실패 처리), 다른 속도로 새 녹음을 요청하고 느린 속도로는 빌드하지 마세요. 마지막 비디오는 3.4로 진행되어 참조의 62초에 비해 71초가 실행되었습니다.
  • 그렇지 않으면 계속하세요: 편집은 문장 번호를 기반으로 구축되므로 자체적으로 재타이밍됩니다. 8단계가 끝날 때까지 음성이 도착하지 않으면 다시 요청하세요; 음성 없이 최종본을 렌더링하지 마세요.

8단계 · 나머지를 막별로 빌드

각 막(1일, 2황혼/밤, 3비)에 대해 순서대로:

  1. 먼저 sets.js에 새 셋과 소품을 승인된 룩 시트 및 바이블의 디테일로 빌드하세요("Not built yet" in engine/API.md 참조).
  2. 막의 모든 설정에 대한 샷 블록, 각각 type, 스토리보드에 따른 전환(7~10프레임의 dissolve, cashBurst()/paperBurst()를 사용한 burst, 와이프 또는 하드 컷) 포함.
  3. 막의 시간 범위에 대한 film.mjs check는 종료 코드 0(FAIL 없음)이어야 합니다. 가장 중요한 FAIL:
    • slow-camera 한계보다 느린 카메라(푸시인은 초당 6~10% 줌해야 함);
    • 유형의 크기 범위를 벗어난 히어로 얼굴;
    • 5~12프레임을 벗어난 디졸브;
    • 붙어 있는 오브젝트에서 떨어진 레이블(decal-overhang): 스티커와 레이블을 on: <surface>로 등록하세요;
    • 프레임 가장자리로 잘리거나, 머리에 가려지거나, 숨겨진 키 텍스트(text-cut). 농담이 의존하는 모든 숫자, 가격, 화면 및 레이블을 셋 또는 샷이 구축될 때 readable(mesh, label, { key: true })로 등록하세요.
  4. 막의 쌍 시트: 우리 설정 중간을 아래 행에, 동일한 비트의 참조 설정을 위에(tools/sbs_sheet.py, $PROFILE/frames의 프레임). 막에서 1:1 비율의 400px 크롭 스트립 하나를 추가하세요.
  5. 전환 검토: 막의 각 전환을 짧은 클립(film.mjs render로 약 1초 범위)으로 렌더링하세요. 프레임별 스트립을 만들고 $PROFILE/transitions/에 있는 동일한 종류의 참조 전환 옆에 놓으세요. 다음을 확인하세요:
    • 컷은 하나의 깨끗한 프레임에서 변경됩니다;
    • 디졸브는 두 샷이 계속 움직이는 동안 완화된 곡선을 따릅니다;
    • 버스트는 프레임의 약 2/3 이상을 덮지 않고, 다음 샷이 그 아래에서 페이드 인됩니다;
    • 와이프 공개

...

[번역을 위해 일부 생략됨]

관련 스킬