Communitygithub.com

nian-pangolin/wan3-drama-skills

剧本转换为电影化分镜脚本,并按≤15秒视频片段切分成「单元」(段落)。每个单元带场次站位描述,每个镜头采用专业景别代号(WS/MS/MCU/CU/ECU)+运镜方式+前景+【画面动作】+【声音设计】+台词,专用于短剧视频生成前的分镜规划与分段。输出格式对齐 分镜.txt。

wan3-drama-skills란 무엇인가요?

이 스킬은 'nian-pangolin/wan3-drama-skills'로, 드라마(또는 시나리오) 대본을 영화적 스토리보드로 변환하고, 각 스토리보드를 15초 이하의 비디오 클립에 해당하는 '유닛(Unit)'으로 분할합니다. 주로 숏폼 드라마(short drama)나 비디오 생성 전 단계에서 분할된 스토리보드를 제공하는 데 최적화되어 있습니다. 입력은 회차, 장면 헤더, 등장인물, 동작 설명(△), 대사, VO/OS 등의 표준 스크립트 형식을 따릅니다. 출력은 순수 텍스트이며, 각 유닛은 장면 내 캐릭터의 공간적 배치(스탠스, 거리, 이동 동선)를 설명하는 '장면 스탠스 설명(Scenes with Stance Descriptions)'을 포함합니다. 각 유닛 내의 샷은 1부터 번호가 매겨지며, 각 행은 반드시 샷 크기 코드(WS/MS/MCU/CU/ECU), 카메라 움직임(고정/트래킹/패닝 등), 포그라운드(foreground) 설명, [화면 동작], [사운드 디자인], 대사(또는 :(无台词))를 순서대로 포함합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트에서 사용할 수 있으며, 대본의 모든 대사와 주요 동작이 누락 없이 샷에 반영되도록 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nian-pangolin/wan3-drama-skills/tree/HEAD/cinematic-storyboard

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

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

문서

영화적 스토리보드 및 유닛 분할 스킬

한 회(또는 여러 회)의 대본을 '영화적 스토리보드'로 변환하고, 스토리보드를 하나씩의 '유닛'(단락)으로 분할합니다. 각 유닛은 ≤15초의 비디오 클립에 해당합니다.

트리거 조건

사용자가 대본 텍스트(회차 헤더, 인물, △동작 설명, 대사, VO/OS 등 포함)를 제공하고 다음을 원할 때:

  • '영화적 스토리보드', '카메라 워크 스크립트', '샷 스크립트' 생성
  • 또는 스토리보드를 '세그먼트/유닛/15초 클립으로 분할'
  • 또는 출력 형식을 '分镜.txt 처럼' 명시적으로 요청

에 이 스킬을 사용합니다.

입력 형식

입력은 한 회 또는 여러 회의 대본이며, 일반적인 구조는 다음과 같습니다:

제X회
X-X 장면명 시간(낮/밤) 실내/실외
인물: 캐릭터1 캐릭터2 ...
자막: (선택사항, 예: 민국·상하이·와이탄)
△동작 설명 (스토리보드 힌트, 보통 △ 또는 【특】 등으로 시작)
캐릭터명(감정/동작 표시): 대사 내용
캐릭터명(VO): 내레이터 독백 대사
캐릭터명(OS): 화면 밖/회상 대사
(플래시백 화면)/(컷 연결)/(전환) 등 마커

출력 형식 (3계층 구조)

출력은 순수 텍스트이며, '회 → 유닛 → 샷'의 3계층 구조를 따릅니다:

제1계층: 회 제목

제X회 스토리보드

제2계층: 유닛 (스토리보드 분할 단락)

각 유닛은 하나의 ≤15초 비디오 클립에 해당하며, 형식:

유닛 N:X-X 장면명 시간 실내/외 장면 스탠스 설명: <해당 클립 내 인물의 공간적 배치, 거리 관계, 동선 설명>
  • 유닛 N: 1부터 시작하여 각 회 내에서 연속 번호
  • 바로 이어서 장면 헤더(원본 유지 X-X 장면명 시간 실내/외), (플래시백), (전환), (회차 말미 훅) 등 상태 표시 가능
  • 장면 스탠스 설명: 뒤에 본 유닛 내 캐릭터의 물리적 위치, 서로 간 거리, 방향, 은폐 위치 등을 설명하여 샷 스케줄링에 공간 기준 제공

제3계층: 샷 행

각 유닛 내 샷은 1부터 번호가 매겨지며, 한 행에 하나의 샷, 형식:

N. 샷 크기 코드 (카메라 움직임) 포그라운드: <포그라운드 설명 또는 "무">。【화면 동작 설명】【사운드 디자인 설명】<대사 부분>
  • <대사 부분>: 대사 있음 캐릭터명: 대사 내용 (VO/OS는 캐릭터명(VO):...); 대사 없음 :(无台词)

샷 행 전체 예시:

4. CU (고정 샷) 포그라운드: 무。【클로즈업 진슈야오 얼굴, 목부터 정수리까지. 그녀의 눈빛이 흐르고, 표정은 오만하지만 여유로움을 담고 있다】【목소리는 낮고 느리며, 약간의 감탄을 담아, 느린 말투】진슈야오: 오늘 밤의 와이탄은 너무 고요하다.
1. WS (로우 앵글 트래킹 샷) 포그라운드: 흐릿한, 빗방울이 맺힌 빈티지 자동차 창문。【진슈야오가 몸에 꼭 맞는 치파오를 입고 문 앞의 빛 속에 서 있다. 카메라는 젖은 돌길에 바짝 붙어 천천히 전진한다】【환경음: 희미한 재즈 음악과 멀리서 들리는 바퀴 소리가 섞인다】:(무대사)

샷 행 필드 상세 설명

1. 샷 크기 코드 (필수, 맨 앞에 위치)

코드의미용도
WS원샷/풀샷 Wide Shot장면 구축, 환경 관계, 군중 연출, 장관 장면
MS미디엄 샷 Medium Shot인물 상반신, 동작, 두 인물 관계, 동선
MCU미디엄 클로즈업 Medium Close-Up가슴 위, 감정 전개, 대화 주력 샷
CU클로즈업 Close-Up'얼굴, 목부터 정수리까지', 감정 폭발, 핵심 소품
ECU익스트림 클로즈업 Extreme Close-Up눈, 손가락, 핏자국, 극한 디테일 강조
  • 얼굴 클로즈업은 통일하여 '특 XXX 얼굴, 목부터 정수리까지'로 설명, 생성 일관성 보장.

2. 카메라 움직임 (필수, 샷 크기 바로 뒤, 한국어에서 영문 괄호 사용)

( ) 안에 쓰며, 카메라 위치와 움직임 설명. 일반적인 단어 모음 (중영어 혼용 가능):

  • 고정류: 고정 샷, 고정 광각, 탑다운 고정
  • 푸시/풀류: 트래킹 샷, 느린 푸시인, 빠른 푸시인, 익스트림 클로즈 푸시인, 트랙 백
  • 팬/틸트류: 팬 샷, 팬 따라가기, 고속 와이드 팬 Whip Pan, 틸트 다운, 시선 유도 틸트 다운 Tilt Down, 느린 틸트 업
  • 앵글류: 로우 앵글 업샷, 하이 앵글 다운샷, 오버 더 숄더 리버스, 오버 더 숄더 샷, 더치 앵글
  • 핸드헬드/추적: 핸드헬드 미세 흔들림, 핸드헬드 흔들림, 스테디캠 따라가기, 그라운드 레벨 핸드헬드 추적, 서라운드 줌
  • 특수/효과: 슬로우 모션 Slow-mo, 매치 컷 Match Cut, 크레인 다운 Crane Down, 포커스 랙, 빠른 포커스 전환, 주관적 시점 POV
  • 전환류: 디졸브 Dissolve, 포그라운드 오버레이 전환 Wipe, 하드 컷 Hard Cut, 푸시인/풀아웃 전환

3. 포그라운드 (필수)

포그라운드: 뒤에 구체적인 포그라운드 가림 물체 또는 무를 씁니다. 포그라운드는 깊이감과 엿보는 듯한 느낌을 조성하는 데 사용됩니다. 예:

  • 포그라운드:흐릿한, 빗방울이 맺힌 빈티지 자동차 창문.
  • 포그라운드:진슈야오의 흐릿한 어깨. (오버 더 숄더/숄더 샷은 반드시 흐릿한 어깨를 씀)
  • 포그라운드:암살자의 총구. / 포그라운드:초점이 나간, 타오르는 붉은 용과 봉황 혼례 촛불.
  • 포그라운드가 없을 때는 포그라운드:무.라고 씁니다.

4.【화면 동작 설명】(첫 번째 대괄호, 필수)

해당 샷 내 구체적인 화면 설명: 캐릭터 동작, 동선, 표정, 카메라 움직임 종착점, 환경 변화. 구체적이고 실행 가능해야 하며, 공간과 방향 정보를 포함해야 합니다.

5.【사운드 디자인 설명】(두 번째 대괄호, 필수)

모든 샷은 독립적인 사운드/연기 레이어 표시를 가져야 하며, 다음 차원 중 하나 또는 조합을 선택:

  • 환경음: 【환경음: 선명한 하이힐 발소리】, 【밤하늘을 찢는 말 울음소리】, 【빽빽한 총성】
  • 호흡/숨: 【호흡: 숨을 깊이 들이마심 0.8초】, 【호흡: 차분한 호흡 여백 1.0초】 (초 단위 포함 가능)
  • 무음 여백: 【무음 여백 2.0초】
  • 미세 표정/연기 힌트: 【미세 표정: 턱 근육 긴장】, 【동작이 가볍고 조용함】
  • 대사 어조 (대사 있을 때): 【목소리는 낮고 느리며, 약간의 감탄을 담아, 느린 말투】, 【큰 목소리로 외침, 볼륨 매우 큼】, 【내면 VO, 목소리가 극도로 절망적이고 쉰 목소리】

6. 대사 부분 (필수, 행 끝)

  • 대사 있음: 캐릭터명:대사 내용
  • 내면 독백: 캐릭터명(VO):대사 내용
  • 화면 밖/회상: 캐릭터명(OS):대사 내용
  • 대사 없음: :(무대사) (앞에 영문 콜론, 예시와 일치)

유닛 분할 규칙 (스토리보드 분할·핵심)

  1. 시간 우선: 각 유닛은 하나의 ≤15초 비디오 클립에 해당. 샷 개수와 리듬으로 추정하여, 보통 유닛당 3-6개 샷.
  2. 분할 기준: 다음 위치에서 새 유닛을 시작:
    • 공간/스탠스가 현저히 변할 때 (캐릭터 동선, 새 인물 등장, 포위망 형성)
    • 장면/시공간 전환 (플래시백 진입, 전환, 현실로 복귀)
    • 극적 비트 전환 (예: 온화→갈등, 대치→폭발)
  3. 장면 스탠스 설명: 각 유닛 시작 시 반드시 본 클립 내 캐릭터의 물리적 위치, 서로 간 거리, 방향, 은폐물을 설명하여, 해당 구역 모든 샷의 공간 기준으로 삼음.
  4. 유닛 일관성: 같은 유닛 내 샷은 동일한 공간과 시간을 공유하며, 샷 간은 연속 동작의 분해.
  5. 회차 말미 훅: 각 회의 마지막 유닛은 장면 설명 뒤에 (본 회 말미 훅) 또는 (회차 말미 훅)을 표시하고, 마지막 샷은 '컷 투 블랙, 서스펜스 훅을 남김'.

샷 분할 규칙 (스토리보드·핵심)

  1. 컷 밀도 최우선: 모든 의미적 쉼표(쉼표, 세미콜론, 어조사), 모든 감정 전환, 언급된 모든 사람/사물마다 샷을 나눌 것. 많이 나누는 것이 적게 나누는 것보다 낫다.
  2. 한 줄 대사에 최소 2-3개 샷: 말하는 사람 → 듣는 사람 반응; 쉼표가 있는 대사는 쉼표로 나누고, 중간에 듣는 사람/언급된 사물 샷 삽입.
  3. 동일 캐릭터 동일 각도 연속 금지: 인접한 두 샷이 인물이 같고 각도가 같다면, 병합하거나 각도/샷 크기를 바꾸거나 반응 샷을 삽입할 것. 긴 대사는 반드시 분절 사이에 구경꾼 반응 삽입.
  4. VO/OS 독립 샷: 내면 독백, 화면 밖 음성, 회상 음성은 독립 샷으로, 주로 클로즈업이나 주관적 시점 샷과 함께 사용.
  5. 중요 △동작 독립 샷: 대사 없는 핵심 동작(총拔기, 낙마, 문 밀기, 피묻은 손도장 찍기)은 독립 샷으로, :(무대사).
  6. 오버 더 숄더/숄더 샷은 반드시 흐릿한 포그라운드 포함: 두 인물 대화/대치는 오버 더 숄더 리버스 우선, 포그라운드:XXX 흐릿한 어깨.
  7. 포그라운드 깊이감: 핵심 샷은 포그라운드(빗방울, 연기, 총구, 문틀, 촛불)를 적극 활용하여 깊이감과 감정 조성.
  8. 대사 중복 금지: 한 줄의 대사를 여러 샷으로 나눌 때는, 의미 단위로 조각을 각 샷에 순서대로 배분하며, 인접 샷의 대사는 절대 중복되지 않음.

샷 크기 / 카메라 움직임 / 사운드 선택 제안

  • 장면 구축 샷: WS + 푸시인/탑다운 + 환경음; 감정 폭발: CU/ECU + 빠른 푸시인 + 호흡; 액션 장면: MS + 핸드헬드/스테디캠 + 빽빽한 음향 효과; 전환: Match Cut / Dissolve / Wipe / Whip Pan.
  • 사운드 디자인: 화면 감정과 매칭해야 함: 조용한 장면은 '무음 여백/호흡', 갈등은 '큰 외침/빽빽한 총성', 임박한 죽음/절망은 '실날 같은 숨소리/공허한 회상'.

전환 및 특수 마커

  • 대본 내 (플래시백 화면), (컷 연결), (전환)은 유닛 장면 표시에서 (플래시백), (전환) 등으로 나타냄.
  • 장면/시공간 전환은 전용 전환 샷 하나로 이어받음 (Match Cut / Dissolve / Wipe / 하드 컷), 【화면】에서 전환 로직 설명 (예: '유사 동작 축 반전', '형태와 동세 매칭').

출력 요구사항

  1. 시작에 회 제목 제X회 스토리보드를 출력.
  2. '유닛 → 샷' 순서로 출력; 유닛 내 샷은 1부터 연속 번호, 유닛 간에는 불연속 (각 유닛이 새로 1부터 시작).
  3. 각 샷은 한 행을 차지, 필드 순서는 엄격히: 번호. 샷 크기 (카메라 움직임) 포그라운드:X。【화면】【사운드】대사.
  4. 각 샷은 반드시: 샷 크기 코드, 카메라 움직임, 포그라운드, 【화면】, 【사운드】, 대사 부분 (대사 없으면 :(무대사))을 모두 포함해야 하며, 하나라도 빠뜨릴 수 없음.
  5. 여러 회 연속 처리 시, 회별로 출력하며, 회와 회 사이는 새로운 제X회 스토리보드 제목 줄을 넣음.
  6. 최종 출력은 순수 텍스트이며, .txt 파일로 직접 저장 가능, 파일명은 分镜.txt 또는 {회차}_分镜.txt 권장.
  7. 커버리지: 대본의 모든 대사, 모든 핵심 △동작에 해당하는 샷이 누락 없이 포함되도록 함. 훅과 전환도 빠뜨리지 않음.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬