Manual · v1.3.2 · KO / EN

설치 3분, 6단계로 한 편 Three minutes to install, six steps to a film

음원을 넣고 → 스토리를 고르고 → 컨셉을 정하고 → 키 스틸을 승인하고 → 생성을 맡기고 → 편집·자막까지. 단계마다 내가 고르는 것, AI가 하는 일, 그대로 붙여 넣는 예시 명령을 모았습니다. Drop the track in, pick a story, settle the look, approve the stills, hand over generation, take the edit and the subtitles. For every step: what you decide, what the AI does, and a line to paste.

6단계는 내가 움직이는 순서, 4단계는 스킬이 지키는 계약입니다. 손으로는 여섯 번 고르지만 스킬 안에서는 4단계·4게이트로 진행됩니다 — 1~4단계가 보드, 5단계가 배치, 6단계가 비주얼 마스터(v1)와 가사 마스터(v2)입니다. 게이트는 “승인 전에는 다음으로 넘어가지 않는다”는 뜻이고, 실제로는 4단계에서 보드가 승인되고 5단계에서 전 컷이 끝났을 때, 6단계에서 파일을 실측했을 때 닫힙니다. Six steps are the order you work in; four stages are the contract the skill keeps. You make six decisions, while the skill moves through four gated stages: steps 1–4 are the board, step 5 is the batch, step 6 is the v1 visual master and the v2 lyric master. A gate means nothing advances until it is passed — the board is approved at step 4, the batch closes when every cut is done at step 5, and step 6 closes on measurements taken from the file.

설치 — 세 가지 방법Install — three routes

01 · Pickle

대화창에 ZIP이나 주소를 그대로Drop the ZIP or the address into the chat

가장 짧은 길the shortest route
  • 내가 할 일 — ZIP 파일을 채팅에 첨부하거나, 아래 주소를 그대로 붙여넣고 설치를 요청합니다.You — attach the ZIP to the chat, or paste the address below as it is and ask for the install.
  • AI가 하는 일 — ZIP을 받아 스킬로 등록하고, 등록 직후 4단계 계약을 한 줄로 요약해 확인시켜 줍니다. 설치가 안 됐다면 그 사실을 그대로 말합니다.The AI — takes the ZIP, registers it as a skill and reads the four stages back to you as a check. If it did not install, it says so instead of pretending.
복붙용Paste this
https://theloz33-bot.github.io/ludyte-mv-studio/ludyte-mv-studio-skill-v1.3.2.zip
이 파일 설치하고, ludyte-mv-studio 스킬이 뭐 하는 스킬인지 4단계로 요약해줘.
https://theloz33-bot.github.io/ludyte-mv-studio/ludyte-mv-studio-skill-v1.3.2.zip
Install this as a skill, then summarise what ludyte-mv-studio does in its four stages.
02 · Claude

웹·앱 — Settings → Capabilities → SkillsWeb and app — Settings → Capabilities → Skills

계정에 한 번 올리면 어느 기기에서나upload once, works on every device
  • 내가 할 일 — 이 페이지에서 ZIP을 내려받고, Settings → Capabilities → Skills에서 업로드한 뒤 목록에서 켭니다. 폴더가 ludyte-mv-studio/ 하나로 들어 있는 ZIP이라 그대로 올리면 됩니다.You — download the ZIP from this page, upload it under Settings → Capabilities → Skills, then switch it on in the list. The ZIP already has one root folder, ludyte-mv-studio/, so it goes up as is.
  • AI가 하는 일 — 업로드된 스킬 본문을 읽고 4단계로 답합니다. 아래 한 줄로 설치를 확인하세요.The AI — reads the uploaded body and answers in four stages. Confirm the install with the line below.
설치 확인Confirm the install
ludyte-mv-studio 스킬이 뭐 하는 스킬이야? 4단계로 요약하고,
가사랑 사진을 주면 어디까지 해주는지도 알려줘.
What does the ludyte-mv-studio skill do? Summarise its four stages,
and tell me how far it takes a set of lyrics and a photo.
03 · Claude Code

터미널 — ~/.claude/skills/ludyte-mv-studioTerminal — ~/.claude/skills/ludyte-mv-studio

PC에서 ffmpeg를 직접 돌릴 때when ffmpeg runs on your own machine
  • 내가 할 일 — ZIP을 받은 폴더에서 아래 두 줄을 실행합니다. ZIP 안의 루트 폴더가 ludyte-mv-studio/라서 ~/.claude/skills/에 그대로 풀면 됩니다.You — run the two lines below in the folder holding the ZIP. Its root folder is already ludyte-mv-studio/, so unzipping into ~/.claude/skills/ lands correctly.
  • AI가 하는 일 — 세션을 새로 열면 스킬을 찾아 읽고, 프로젝트 폴더 안에서만 파일을 만듭니다(stills/·raw/·out/·subs/).The AI — finds and reads the skill in a new session and writes only inside the project folder (stills/, raw/, out/, subs/).
개인 설치 / 프로젝트별Personal / per project
unzip -o ludyte-mv-studio-skill-v1.3.2.zip -d ~/.claude/skills/
ls ~/.claude/skills/ludyte-mv-studio

# 프로젝트 안에만 넣을 때
mkdir -p .claude/skills && unzip -o ludyte-mv-studio-skill-v1.3.2.zip -d .claude/skills/
설치 뒤 준비물. 컷을 자르고 자막을 굽는 일은 ffmpeg가 합니다 — 5.1 이상이 필요하고 xfade와 subtitles(libass)가 들어 있어야 합니다. 한글 자막은 fonts/에 넣은 .ttf로 굽고, 없으면 네모로 나옵니다. 확인 명령과 폰트·계정 목록은 다운로드 섹션에 있습니다. What the runtime needs. ffmpeg does the cutting and the burning — version 5.1 or newer with xfade and subtitles (libass). Korean is burned with the .ttf you put in fonts/; without one it renders as boxes. The check command, fonts and accounts are in the download section.

6단계 실전 워크플로우The six-step working order

1

음원 넣고 분석 — 파일에서 숫자를 먼저Feed the track in, read the numbers off the file

contract · stage 1 input
내가 할 일You
  • MP3/WAV를 채팅에 첨부하고, 가사는 .txt로 주거나 파일에 USLT 태그로 들어 있으면 그대로 둡니다.Attach the MP3/WAV; give the lyrics as a .txt, or leave them in the file's USLT tag.
  • 목표 러닝타임·비율·룩을 한 줄로 정합니다. 예: 30초·16:9·시네마틱 실사·립싱크 없이.Fix the target runtime, aspect and look in one line: 30 s, 16:9, cinematic photoreal, no lip sync.
  • 릴스·쇼츠로 낼 거면 9:16(768×1366)으로 미리 말합니다. 한 편에 두 비율을 섞지 않습니다.Say 9:16 (768×1366) up front for reels or shorts — one film never mixes ratios.
AI가 하는 일The AI
  • 파일에서 길이·프레임 수·샘플레이트를 실측하고(ffprobe), 내장 가사 태그가 있으면 그대로 뽑아 씁니다.Measures length, frame count, sample rate on the file with ffprobe and pulls the embedded lyric tag if there is one.
  • BPM과 구간(인트로·벌스·후렴·브리지)을 표시합니다 — 파일에 TBPM 태그가 있으면 그 값을 쓰고, 없으면 박자를 세어 잡되 추정이라고 밝힙니다. 실측은 어디까지나 파일에서 읽은 숫자입니다.Marks BPM and sections (intro, verse, chorus, bridge) — reading a TBPM tag when the file carries one, otherwise counting beats and labelling it an estimate. Only what came off the file counts as measured.
  • 러닝타임에서 컷 수를 역산합니다 — 30초는 4~6컷, 10컷×5초는 50초를 생성해 30초만 쓰는 낭비입니다. “30.000초 = 720프레임 @24fps”처럼 숫자로 확정합니다.Derives the cut count from the runtime — 30 s is 4–6 cuts, and ten 5 s jobs generate 50 s for 30 s of film. It settles on numbers: “30.000 s = 720 frames at 24 fps”.
복붙용 예시 명령A line you can paste
이 MP3랑 가사야. 파일에서 길이·BPM·구간(인트로·벌스·후렴·브리지)·내장 가사 태그부터 확인해줘.
30초·16:9·시네마틱 실사, 립싱크 없이 갈 거야. 러닝타임이랑 컷 수부터 숫자로 확정하자.
Here is the track and the lyric sheet. Read the length, BPM, sections (intro, verse, chorus, bridge) and any embedded lyric tag off the file first.
30 s, 16:9, cinematic photoreal, no lip sync. Settle the runtime and the cut count in numbers before we go on.
2

스토리 기획·선택 — 여기서는 아직 아무것도 만들지 않습니다Pick the story — ask again as often as you like

contract · stage 1 board
내가 할 일You
  • 분위기·주인공·배경 후보 중 하나를 고릅니다. 마음에 안 들면 몇 번이든 다시 시킵니다.Choose one of the moods, protagonists or settings on offer — and ask again as often as you like.
  • 실제 인물을 화면에 세우려면 레퍼런스 사진 1장을 같이 줍니다. 사진이 없으면 텍스트로는 스타일만 잡히고 얼굴은 컷마다 흔들립니다.For a real face on screen, add one reference photo. Without it, text can carry a style but not an identity, and the face drifts between cuts.
  • 곡이 길면 “30초만”처럼 어디를 쓸지 정합니다 — 줄 수가 아니라 초가 기준입니다.For a long song, say which 30 seconds you want — the film is counted in seconds, not in lyric lines.
AI가 하는 일The AI
  • 곡의 정서를 기준으로 시나리오 3~4개를 로그라인·분위기·배경·필요한 샷으로 나눠 제시합니다.Offers three or four directions separated into logline, mood, setting and the shots each needs.
  • 고른 안을 10비트 골격(콜드 오픈 → 캐릭터 락 → 벌스 → 후렴 → 브릿지 → 엔딩)에 얹고, 컷 수에 맞춰 비트를 합칩니다.Maps the choice onto the ten-beat skeleton (cold open → character lock → verse → chorus → bridge → outro) and merges beats to fit the cut count.
  • 가사는 2~4줄에 한 컷으로 묶습니다. 한 줄에 한 컷은 10컷이 되어 30초 영화에 담기지 않습니다.Groups lyrics at one cut per 2–4 lines; a cut per line would make ten cuts and overrun a 30 s film.
복붙용 예시 명령A line you can paste
이 곡으로 갈 만한 스토리 시나리오 3개만, 로그라인·분위기·배경·필요한 샷으로 정리해줘.
내가 하나 고르면 그걸로 보드까지 바로 만들어줘.
Give me three story directions for this song — logline, mood, setting and the shots each one needs.
I will pick one, then board it straight away.
3

컨셉 이미지 — 얼굴·옷·색·조명을 고정Concept images — lock the face, wardrobe, colour and light

contract · stage 1 style bible
내가 할 일You
  • 나온 컨셉 이미지에서 주인공 인상·의상·색·조명 방향을 승인합니다. 이 네 가지가 이후 모든 컷의 기준이 됩니다.Approve the face, wardrobe, palette and light. Those four become the reference for every cut that follows.
  • 한 편에 옷은 한 벌이 기본입니다. 옷이 바뀌면 관객은 시간이 바뀐 걸로 읽습니다.One outfit per film by default — a wardrobe change reads as a jump in time.
  • 마음에 안 드는 부분만 말합니다(예: “머리는 더 짧게, 조명은 더 차갑게”). 전체를 다시 뽑게 하면 앞의 선택이 흔들립니다.Say only what is off (“shorter hair, colder light”); re-rolling everything unsettles what you already approved.
AI가 하는 일The AI
  • 스타일 바이블을 만듭니다 — Subject lock(얼굴형·머리·안경·표식) · Wardrobe · World · Palette(색 3개와 쓰이는 곳) · Motif(반복되는 사물).Writes the style bible — subject lock (face shape, hair, eyewear, mark), wardrobe, world, palette (three named colours and where they live), motif.
  • 이 블록을 모든 스틸과 모든 프롬프트에 그대로 다시 씁니다. 이게 컷 사이의 얼굴을 붙잡는 유일한 장치입니다.Reuses that block verbatim in every still and every prompt — the only thing holding the face together across cuts.
  • 무드 레퍼런스 시트를 2~4장 뽑아 고르게 하고, 화면 글자·로고·가짜 로고 조각은 미리 걷어냅니다.Renders two to four mood references to choose from, with no on-screen text, logo or stray lettering.
복붙용 예시 명령A line you can paste
1번으로 가자. 주인공·의상·색·조명을 스타일 바이블로 고정하고,
컨셉 이미지 4장 뽑아서 고르게 해줘. 768p, 16:9, 화면 글자 없이.
Go with number one. Lock the character, wardrobe, palette and light into a style bible,
then give me four concept images to choose from — 768p, 16:9, no on-screen text.
4

키 이미지(스틸) — 보드 승인은 여기서Keyframe stills — the board is approved here

contract · stage 1 keyframes, gate 1
내가 할 일You
  • 컷별 스틸을 검수합니다 — 얼굴 일관성·손·소품 모양·옷·글자 조각. 이상한 컷만 다시 뽑게 합니다.Check each still for face consistency, hands, prop shape, wardrobe and lettering, and have only the bad ones redone.
  • 여기까지는 본편 생성이 아직 시작되지 않은 구간입니다(스틸 제외). 보드·프롬프트 수정은 여기서 몇 번이든 하세요.Up to here nothing is generated for the film itself (the stills aside) — make every board and prompt change you want now.
  • “이 보드로 간다”고 말하는 순간이 게이트입니다. 그 뒤의 수정은 새 생성으로 다시 만드는 일이 됩니다.Saying “this board is it” is the gate; after that, a fix means generating again.
AI가 하는 일The AI
  • 컷마다 첫 프레임 스틸을 768p로 만들고 stills/S01_{SHOT}.png로 저장합니다.Renders one first-frame still per cut at 768p and saves it as stills/S01_{SHOT}.png.
  • 컷별 영상 프롬프트를 씁니다 — 동작 하나·카메라 무브 하나·입 닫힘·화면 글자 없음·길이. 가사는 프롬프트에 인용하지 않습니다(인용하면 입이 움직입니다).Writes the video prompt per cut — one action, one camera move, mouth closed, no on-screen text, duration. Lyrics are never quoted in a prompt; a quoted line animates the mouth.
  • 스틸을 컷 카드 사이에 붙여 순서대로 보여주고, 이 보드로 쓸 러닝타임·프레임 수를 마지막에 다시 적습니다.Pastes each still between the cut cards so the board reads as a sequence, and closes with the runtime and frame count the master will be cut to.
복붙용 예시 명령A line you can paste
컷마다 키프레임 스틸을 768p로 만들고, 얼굴·손·옷·글자 일관성 검수해서 이상한 컷만 다시 뽑아줘.
다 되면 컷 카드 사이에 스틸을 붙여서, 컷별 영상 프롬프트랑 같이 보여줘. 이 보드로 갈게.
Make one keyframe still per cut at 768p, check face, hands, wardrobe and lettering, and redo only the bad cuts.
Then show the stills between the cut cards together with each cut's video prompt. This is the board I'm approving.
게이트 1 — 보드 승인. 승인 전에는 생성 태스크를 하나도 등록하지 않습니다. 사전 승인된 실행이라면 이 게이트는 이미 열려 있습니다.Gate 1 — board approved. No generation task is registered before this. A pre-authorised run already has this gate open.
5

영상 생성·검토 — 실제 생성이 도는 구간Generate and review — where the clips are actually rendered

contract · stage 2 batch, gate 2
내가 할 일You
  • 컷 수·길이·해상도를 확인하고 “생성 시작”을 승인합니다. 생성 1건은 한 번 등록하면 되돌릴 수 없는 실행입니다.Check count, length and resolution, then say start. A generation is a run that cannot be taken back once registered.
  • 결함 보고가 오면 재생성할지 내가 정합니다. 스킬은 스스로 다시 돌리지 않습니다.When a fault is reported, you decide whether to re-roll; the skill never does it on its own.
  • 큐가 밀리면 기다립니다. 확인은 수십 분 주기로 하고, 그동안 다른 일을 하세요.If the queue is slow, wait — checks run every few tens of minutes, so go do something else.
AI가 하는 일The AI
  • 컷당 한 건만 등록하고, 플랫폼이 준 태스크 ID를 가장 먼저 매니페스트에 적습니다. 기록 없는 태스크는 나중에 확인할 수 없는 작업입니다.One task per cut, with the task id written into the manifest first — an untracked task is one nobody can account for afterwards.
  • 끝난 컷만 원본 그대로 받아 해상도·길이·오디오를 실측합니다(재인코딩 금지).Downloads only finished cuts, originals untouched, and probes resolution, duration and audio.
  • 실패·결함 컷은 재제출하지 않고 한 번 보고하고 멈춥니다. 플랜 변경·진행 중 작업 취소도 하지 않습니다.A failed or faulty cut is reported once and stopped — no resubmit, no plan change, no cancelling an in-flight job.
복붙용 예시 명령A line you can paste
이 컷들 전부 768p·16:9·5초로 생성 시작해. 매니페스트에 태스크 ID부터 기록하고,
끝난 컷만 원본 그대로 받아서 해상도·길이 실측해줘. 이상한 컷은 다시 돌리지 말고 먼저 보고해.
Start generating all these cuts at 768p, 16:9, 5 seconds. Record every task id in the manifest first,
download only finished cuts as originals and probe resolution and duration. Report a bad cut instead of re-rolling it.
게이트 2 — 전 컷 DONE·다운로드 완료 또는 실제 블로커를 보고했을 때. “대충 된 것 같다”로는 넘어가지 않습니다.Gate 2 — every cut DONE and downloaded, or a real blocker reported. “Looks about done” does not open it.
6

자동 편집·자막 — 두 마스터를 한 번에Assemble and subtitle — both masters in one pass

contract · stages 3 + 4, gates 3 and 4
내가 할 일You
  • 먼저 v1(무음)을 보고 수정을 지시합니다 — 컷 순서·박자·전환. 자막은 아직 없습니다.Watch v1, the silent cut, and ask for changes — order, beats, transitions. There are no subtitles yet.
  • 자막 언어와 위치를 정합니다 — 한글 위·영어 아래, 9:16이면 세이프존까지.Settle the subtitle languages and placement — Korean above, English below, with the 9:16 safe zone respected.
  • 음원을 최종 파일로 확정합니다. 스킬은 음악을 구하거나 만들지 않습니다.Hand over the final track file. The skill never sources or generates music.
AI가 하는 일The AI
  • 프레임 단위로 조립합니다 — 하드컷·매치컷·크로스페이드. 크로스페이드는 겹친 만큼 영화가 짧아지므로 컷 길이에서 미리 보정합니다.Assembles frame by frame — hard cuts, match cuts, crossfades — and adds each fade's overlap back to the cut lengths beforehand.
  • v1_visual_master.mp4를 렌더하고 실측합니다 — 프레임 수·fps·해상도·무음. 그 다음 같은 실행에서 자막을 굽고 음원을 합쳐 v2_lyric_master.mp4를 냅니다.Renders v1_visual_master.mp4 and probes it — frames, fps, resolution, silence — then in the same run burns subtitles and muxes the track into v2_lyric_master.mp4.
  • subs/lyrics.ass·subs/lyrics.srt와 master_report.md를 같이 냅니다. 확인하지 못한 것은 리포트에 그대로 적습니다.Ships subs/lyrics.ass, subs/lyrics.srt and master_report.md too, with anything unverified written down as such.
복붙용 예시 명령A line you can paste
정확히 30초로 조립해줘. 박자에 하드컷, 후렴 들어갈 때 0.25초 크로스페이드.
무음 v1 만들고 실측한 다음, 같은 실행에서 한글 가사는 위·영어는 아래로 굽고
내 음원 넣은 v2까지 같이 줘. 자막 원본(ass·srt)도 같이.
Cut it to exactly 30 seconds — hard cuts on the beats, a 0.25 s crossfade into the chorus.
Render and probe the silent v1, then in the same run burn Korean on top and English beneath and mux my track into v2.
Send the subtitle sources (ass and srt) with them.
게이트 3 — v1을 파일에서 실측(프레임·fps·해상도·무음), 게이트 4 — v2의 큐 타이밍·세이프존을 프레임에서 확인하고 오디오를 검증. 둘 다 숫자로 끝나야 납품입니다.Gate 3 — v1 measured on the file (frames, fps, resolution, silence); gate 4 — every v2 cue's timing and safe zone checked on frames with the audio verified. Both close in numbers, or it is not a delivery.
여섯 번을 한 번에 말해도 됩니다. 아래처럼 한 문단으로 던지면 AI가 단계마다 멈춰서 승인을 받고 이어갑니다 — 게이트를 건너뛰지 않습니다. You can also say all six at once. Hand it over as one paragraph and the AI still stops at each gate for your yes — it does not skip one.
음원이랑 가사 첨부했어. 30초·16:9·시네마틱 실사, 립싱크 없이.
먼저 스토리 3개 제안하고, 내가 고르면 보드·키프레임 스틸까지 만들어줘.
스틸 승인하면 전 컷 생성하고, 끝나면 무음 v1 → 한글/영어 자막 + 내 음원 v2까지 한 번에.
Track and lyrics attached. 30 s, 16:9, cinematic photoreal, no lip sync.
Offer three story directions first; when I pick one, board it with the keyframe stills.
Once I approve the stills, generate every cut, then take me from the silent v1 to v2 with Korean/English lyrics and my track in one pass.

6단계와 4단계 계약의 대응How the six steps map onto the four stages

6단계Step 그때 정하는 것Decided there 스킬 계약Contract 게이트Gate
1 · 음원 분석1 · Track analysis 러닝타임·컷 수·비율·구간runtime, cut count, aspect, sections 1 보드 — 입력1 Board — input —
2 · 스토리 선택2 · Story 시나리오·비트 골격scenario, beat skeleton 1 보드1 Board 보드 승인board approved
3 · 컨셉 이미지3 · Concept images 얼굴·의상·색·조명(스타일 바이블)face, wardrobe, palette, light 1 보드 — 스타일1 Board — style 보드 승인board approved
4 · 키 스틸4 · Keyframe stills 컷별 첫 프레임·프롬프트first frame and prompt per cut 1 보드 — 키프레임1 Board — keyframes 여기서 승인 (게이트 1)approval happens here (gate 1)
5 · 영상 생성5 · Generation 컷당 클립 1건, 실패는 보고one clip per cut; faults reported 2 배치2 Batch 전 컷 DONE·다운로드 (게이트 2)every cut DONE (gate 2)
6 · 편집·자막6 · Edit and subtitles v1 무음 마스터 + v2 가사 마스터v1 silent master + v2 lyric master 3 비주얼 + 4 가사3 Visual + 4 Lyric 실측·오디오 검증 (게이트 3·4)probe and audio verified (gates 3–4)
실제 생성이 도는 곳은 4단계(스틸)와 5단계(클립)뿐입니다. 6단계 편집·자막은 이미 디스크에 있는 파일 위의 ffmpeg 작업이라 생성 대기열(큐)을 거치지 않습니다. 그래서 스토리·보드·프롬프트는 1~4단계에서 최대한 끝내는 게 맞습니다 — 그 뒤의 수정은 새 생성으로 다시 풀어야 합니다. Generation runs only at step 4 (stills) and step 5 (clips). Step 6 is ffmpeg over files already on disk and never enters the generation queue. That is why story, board and prompts belong in steps 1–4: a change after generation means generating it again.

다음으로 읽을 것 — 샷 프롬프트 48종 · 제작 규격(프레임 산수·ffmpeg·세이프존) · 문제 해결 · 다운로드·준비물 Read next — the 48 shot prompts · production specs (frame maths, ffmpeg, safe zones) · troubleshooting · download and requirements