Communitygithub.com

stickman-video-master-skill

코드로 힌디어 호러 및 미스터리 쇼츠를 제작합니다: 리서치, 대본, 캐릭터 디자인, 장면 구성, 음성 더빙, 믹싱 및 1080×1920 내보내기.

stickman-video-master-skill란 무엇인가요?

이 스킬은 인도 호러/미스터리 힌디어 쇼츠(1080×1920, 30fps)를 완전히 코드 기반으로 제작하는 파이프라인입니다. 리서치, 대본 작성, 캐릭터 디자인, 장면 구성, 음성 더빙, 믹싱, 품질 검수까지 모든 단계가 포함되어 있습니다. 주로 Claude AI(또는 유사 에이전트)에서 실행되며, Playwright, GSAP, FFmpeg, Whisper 등의 도구를 활용합니다. 참고 데모로 `demo/demo_10s.mp4` 파일과 `code/`, `vo/` 폴더의 코드가 함께 제공됩니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/i-amraj/stickman-video-master-skill/tree/HEAD

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

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

문서

Stickman Video Master Skill — 대본에서 최종 릴까지

완전하고 검증된 파이프라인: 인도 호러/미스터리 힌디어 쇼츠(1080×1920, 30fps)를 코드로 제작합니다 — 리서치, 대본, 캐릭터 디자인, 장면 구성, 음성 더빙, 믹싱, 품질 검수. 참고 제작물: Bhangarh 릴 (데모 영상은 demo/demo_10s.mp4 파일이며, 동일 스타일의 모든 코드는 code/ 및 vo/ 폴더에 있습니다).

STEP 0 — 리서치 (대본 작성 전)

  • 실제 장소/이야기에 대한 심층 리서치: Wikipedia + 공식 출처 (ASI 게시판과 같은 1차 증거).
  • 모든 주장에 태그를 붙이세요: [DOCUMENTED] (증거 있음) · [LEGEND] (민담) · [NAHI MILA] (대본에 넣지 마세요).
  • 확인되지 않은 바이럴 주장은 절대 넣지 마세요 — 먼저 확인하세요. (Bhangarh 교훈: "유일하게 밤에 출입이 금지된 요새"는 잘못된 정보로 판명되어, 대본에서 제거했습니다.)
  • 수요 확인: 같은 주제의 가장 큰 YouTube 동영상을 확인하세요 — 어떤 각도가 성공했는지 (야간 방문, 게시판 클로즈업, 순수 이야기).

STEP 1 — 대본 작성

  • 첫 문장 = 전체 사건 (훅). 첫 줄/프레임에 답의 단서를 숨기세요.
  • 각 문장 6–12 단어; 총 ~150 단어 ≈ 49초 @ ~190 wpm.
  • 캐릭터의 이름을 정하세요. 먼저 밝히고, "왜냐하면"은 나중에.
  • 중간에 "당신"에게 도전을 제시하고, 마지막에 한 단어 댓글 미끼를 넣으세요 (네 또는 아니요?).
  • 자주 쓰는 표현: "실제로는 / 즉 / 자세히 보세요 / 잠시 생각해보세요". 금지: AI 단어 (수수께끼, 사실, 스릴, 센세이션).
  • 캐릭터 대사 규칙: 선택된 2–4개의 대사만 캐릭터 자신의 목소리로; 나머지는 모두 내레이션. 지어낸 대사는 금지.
  • 페이싱 검증: 음성 더빙 2.3–2.7 단어/초 · 데드 에어 >12% = 삭제 · 제목이 답을 스포일러하지 않아야 함.

STEP 2 — 스토리보드 + 기하학 고정

  • 대사 → 장면 테이블 (각 대사의 t0–t1을 미리 정함). 그런 다음 ASCII 좌표 고정: 각 세트의 바닥(FLOOR), 캐릭터 위치, 각 비트의 카메라.
  • 먼저 스케치, 그 다음 외관 — 스케치 없이 바로 최종 코드로 가지 마세요.

STEP 3 — 캐릭터 디자인 (코드 code/my_builder.js)

  • 캐릭터 = 엔지니어링된 SVG 액터 (~640 유닛): 2-세그먼트 FK 관절 (엉덩이→무릎, 어깨→팔꿈치), 둥근 관절, 역할별 턱 모양 얼굴 경로.
  • 각 역할의 DNA 팔레트: 피부, 홍채, 의상, 특별 표식 (망티카, 틸락, 파그디).
  • 이마 디테일 (틸락)은 머리카락 레이어 다음에 만드세요 — 그렇지 않으면 머리카락 아래에 숨겨집니다.
  • 연기 API: setFaceMood · lookEyes · poseArms · speakHuman (입 모양) · walkHuman (실제 걷기 주기 — 슬라이드 = 심각한 실패).
  • 손: 손바닥 + 엄지 + 손가락 선. 모든 액터에 깜빡임 루프 + 호흡.
  • 품질 기준: 캐릭터를 기본 도형 (원형 머리, 원통형 몸통)으로 만들지 마세요 — 조각된 경로만 사용합니다.

STEP 4 — 세트 디자인 (코드 code/my_head.js, my_scenes_a/b.js)

  • 재질 먼저: 모든 표면은 다중 중지 그래디언트 (iGrad) + 실제 그림자; 단색 = 실패.
  • 방 = 3D 쉘: 뒷벽 + 원근감 있는 측벽 + 바닥 다각형 + 베이스보드.
  • 돌담: 각 돌은 다른 색조 + 하이라이트 선 + 날씨 자국 (절차적 돌 텍스처) — 욕실 타일 반복 = 실패.
  • 바위/암석: 불규칙한 12점 다각형 + 3면 음영 + 균열 + 모래 자국 + 접촉 그림자. 팔각형/슬래브 = 심각한 실패.
  • 살아있는 소품: 흔들리는 램프, 하반의 불꽃 + 연기, 까마귀, 안개 (약하게!) — 하지만 FX 효과를 켜둔 상태로 두지 마세요, 각 FX의 OFF 비트가 필수입니다.
  • 카메라 법칙: 각 camTo 전에 뷰 하단 계산 — cy + 960/s ≤ 1920, 그렇지 않으면 프레임 아래에 하늘/검은 여백이 보입니다.
  • 하늘 사각형은 항상 전체 높이.

STEP 5 — 조립 + 렌더링

  • 엔진 코어 = 조립된 html의 접두사 (쉘 svg#stage + defs + rig + 도우미 E/iGrad/makeCam/seekWrap) + 장면 파일 + 닫는 태그. gsap.min.js를 함께 두세요 — 파일 복사를 && 체인에 넣지 마세요 (하나 실패하면 나머지 모두 중단됨).
  • 타임라인은 GSAP 기반; 렌더링은 결정적 seek 방식: Playwright 1080×1920 → window.seekToTime(t) 각 프레임 → JPEG q88 → ffmpeg libx264 crf18. ~20초 청크로 렌더링 (VM 재시작 방지), 재개 가능 패턴 (프레임 >10KB이면 건너뛰기).
  • GSAP 교훈: 이미 변환(translate+scale)이 적용된 그룹에는 x/y 트윈을 사용하지 마세요 — attr transform 절대 트윈을 사용하세요.
  • 긴 자막 줄: 렌더 스크립트에서 getComputedTextLength() > 1030일 때 textLength=1030 수정자 실행.
  • poseArms 부호: armR을 프레임 기준 왼쪽으로 회전 = 양수 회전. 쓰러진 캐릭터: wrap −84°에서 머리가 약 530 유닛 왼쪽으로 이동 — 머리의 최종 위치를 미리 계산하여 wrap 설정.

STEP 6 — 자체 감사 루프 (각 장면)

  • 테스트 스틸 이미지 추출 (각 장면 중간 + 문제 프레임) → 직접 확인 (확대 크롭도) → 수정 → 다시 스틸.
  • 3가지 감사: 예술적 (구도, 색상) · 물리적 (해부학, 그림자, 바닥 연결) · 스토리 (내레이션 일치, 표정 반전 여부).
  • 점수 /100; 95+만 최종 합격. 심각한 실패 (부러진 팔, 떠 있는 물체, 반전된 그림자, 잘못된 소품)는 점수를 무시합니다.
  • 배너/자막은 화면 공간에 배치: 머리 화면-y = (wy − cy)·s + 960; 배너 118–222, 자막 1652+ 바깥.

STEP 7 — 음성 더빙 (코드 vo/fit_lines.py)

  • 모델 gemini-3.8-flash-tts (기본) / gemini-3.1-flash-tts-preview (429 오류 시에만 폴백). 2.5 TTS 금지. 모델당 할당량 10회/일 — 예산을 미리 계산하세요.
  • 내레이션 = 단일 호출, 전체 대본을 한 번에. 텍스트를 RAW로 보내세요 — 긴 스타일 지시는 속도를 2.5배 느리게 하고 때로는 방향 자체를 말하기도 합니다.
  • 목소리: 내레이션 Puck (Raj 선호, @i.raj1801 릴의 기본값) · 악당/다른 목소리 Algenib.
  • TTS WAV = 48000 Hz로 제공됨 — 실제 속도로 피치 계산: pitch ×1.12 = asetrate 53760 (rubberband 절대 사용 금지 — 에코 발생). 악당을 무겁게 만들려면 ×0.96.
  • 대사 맞춤: Whisper (small, 언어 hi)로 테이크의 세그먼트 추출 → 각 대사 자르기 → 일시 정지 압축 (silenceremove) → 피치 → 줄별 atempo로 자막 창에 정확히 맞춤.
  • Whisper에 WAV를 stdlib wave+numpy로 디코딩하여 제공 (PyAV metadata_errors TypeError 발생).

STEP 8 — 믹싱 (코드 vo/mix.py)

  • BGM은 각 릴마다 새로 — 절대 재사용 금지; 라이센스 안전 (Kevin MacLeod 라이브러리). 볼륨 ~0.10, 음성 더빙 아래.
  • SFX 비트맵: whoosh (던지기), impact (충돌/낙하), thunder (번개/저주), riser (저주 전).
  • Loudnorm 2-pass (측정 → 선형 적용) = −14.0 LUFS, TP ≤ −1.5. 단일 패스는 종종 −15.8에서 멈춤.
  • 먹싱: 비디오 스트림 복사 + AAC 192k.

STEP 9 — 최종 QC + 전달

  • 전달 파일을 Whisper로 듣기 — 모든 대본 줄이 올바른 순서/시간에 있는가? 소스 테이크 검증만으로는 충분하지 않습니다.
  • 길이, 크기, LUFS 세 가지를 모두 확인하여 보고.
  • 전달 교훈: 비디오 파일 이름을 재사용하지 마세요 — 앱이 이전 복사본을 캐싱하여 표시합니다. 각 새 전달 = 새 이름 (v2, _Final, 날짜).
  • 완벽한 (Raj 승인) 비디오는 Perfect_Videos/<date>/ 폴더에 저장됩니다 — 완벽한 것만.

파일 가이드

  • script/Script_v1.md — Bhangarh 대본 + 진실/이야기 태그 + 페이싱 확인 (템플릿으로 사용)
  • code/my_head.js — 셰이더, HUD, drawStoneWall / drawRealBoulder / drawPerfumeBottle / drawAsiBoard / drawHangingLamp
  • code/my_builder.js — buildBhangarhActor (5 역할, 전체 리그)
  • code/my_scenes_a.js / my_scenes_b.js — 8세트 + 타임라인 + 자막
  • code/props_snippet.js / api_snippet.js — 나무/잔디 + 연기 API
  • code/render_test.py / render_full.py — 스틸 + 전체 렌더 (재개 가능)
  • vo/fit_lines.py / vo/mix.py — 음성 더빙 맞춤 + 최종 믹스
  • docs/ — 시각 시스템 개요 + 교훈
  • demo/demo_10s.mp4 — 이 파이프라인의 10초 샘플 장면 (실제 릴은 여기에 공개되지 않음)

관련 스킬