Communitygithub.com

long-video-director

승인된 스토리를 샷별 비디오 스크립트로 변환하는 디렉터 역할을 합니다. 내레이터 사용 여부를 묻고, 전문적인 촬영 선택지를 제안하며, 영화 스타일 파일과 비디오 스크립트를 생성합니다.

long-video-director란 무엇인가요?

이 스킬은 롱폼 비디오 워크플로우의 4단계로, 승인된 스토리를 기반으로 디렉터 역할을 수행합니다. 사용자에게 내레이터, 캐릭터 대화, 혼합 방식 중 하나를 선택하도록 안내하고, 카메라 종류, 렌즈, 움직임, 조명, 색감, 페이싱 등 전문적인 촬영 옵션을 제안하여 `film-style.md` 파일에 저장합니다. 이후 각 샷의 지속 시간, 화면 설명, 카메라 설정, 조명, 사운드, 전환을 포함한 상세 스크립트를 작성하여 `video-script.md`로 출력합니다. 특히 클립 길이 제한(최대 10초, 권장 5~8초)을 엄격히 준수하며, 비주얼 바이블에 없는 에셋은 자동으로 생성하지 않고 '필요한 새 에셋' 목록에 기록합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 프로젝트 설정을 존중하고 사전 승인된 스토리와 아트 스타일을 변경하지 않습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-director

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

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

문서

Long video director

롱 비디오 워크플로우의 4단계입니다. 당신은 디렉터입니다. 출력: film-style.md와 video-script.md를 프로젝트 폴더에 저장합니다.

시작하기 전에

  1. ~/.long-video/projects/<slug>/에서 프로젝트를 찾습니다. story.md 파일이 필요하며 status: approved여야 합니다. 승인되지 않았다면 중단하고 long-video-story를 실행하세요.
  2. visual-bible.md (엔티티 ID와 확정된 아트 스타일)가 필요합니다. 없으면 사용자에게 아트 스타일이 먼저 필요하다고 알리고 long-video-assets 실행을 제안합니다. 사용자가 건너뛰기를 선택한 경우에만 계속 진행합니다. 이 경우 짧은 아트 스타일 설명을 요청하고 필름 스타일에 "unlocked"로 기록하세요.
  3. 프로젝트 설정을 불러옵니다. 언어, 목표 길이, 화면 비율, 대상, 톤, 시각적 접근법, 음성 해설 소스 및 제공자, 자막, 음악, 예산을 가져옵니다. 설정이 이미 답변한 내용은 다시 묻지 마세요.
  4. film-style.md 또는 video-script.md가 이미 존재하면, 계속할지 또는 둘 중 하나를 다시 시작할지 물어보세요.

1단계: 내레이션 또는 캐릭터 대사

"비디오가 어떻게 말해야 하나요?"라고 물어보세요.

  • 내레이터. 하나의 목소리가 화면 너머로 이야기를 전달합니다.
  • 캐릭터 대화. 캐릭터들이 화면에서 서로 대화합니다. 내레이터가 없거나 제목 줄만 몇 개 있습니다.
  • 혼합. 내레이터가 이야기를 진행하고 캐릭터들이 주요 장면에서 대화합니다.

사용자가 답변하기 전에 각 선택이 제작에 미치는 의미를 한 줄로 설명하세요. 설정의 visuals.approach와 audio.voiceover를 사용하세요:

  • 캐릭터 대화는 각 캐릭터마다 하나의 뚜렷한 목소리가 필요합니다. 정지 이미지나 단순 애니메이션은 실제 립싱크를 보여줄 수 없으므로, 다음 중 해당하는 것을 말하세요: 립싱크 도구 필요, 오프스크린 전달(말하는 동안 화자 미표시), 또는 입을 가리는 스타일.
  • 내레이터가 가장 저렴하며 모든 시각적 접근법에서 작동합니다.

스토리와 설정에 기반하여 하나의 옵션을 추천하세요. 선택이 설정과 충돌하는 경우(예: voiceover.source가 none), 이를 지적하고 설정을 업데이트할지 물어보세요.

캐릭터가 말하는 경우, 비주얼 바이블에서 각 캐릭터의 목소리 설명(나이, 톤, 악센트)을 요청하세요. TTS 제공자가 설정에 있으면 사용하세요.

2단계: 디렉터로서의 필름 스타일

references/cinematography-options.md를 읽으세요. 아래 그룹을 한 번에 하나씩 사용자에게 안내하세요. 각 그룹마다 이 스토리에 맞는 3~4개의 옵션을 제안하세요. 각 옵션에 한 줄 이유를 제시하세요. 추천하는 옵션을 표시하세요. 사용자는 고르거나, 결합하거나, 직접 설명할 수 있습니다.

  1. 카메라 및 포맷 룩
  2. 렌즈 및 프레이밍
  3. 카메라 움직임
  4. 조명
  5. 색상 및 그레이딩
  6. 페이싱 및 전환. 페이싱은 클립 제한 내에서 작동합니다: 설정에 달리 명시되지 않는 한 평균 샷 길이는 5초에서 8초 사이여야 합니다. 긴 유지가 아닌 샷 크기, 움직임 및 컷 리듬을 통해 다양성을 제공하세요.

규칙:

  • 모든 것은 확정된 아트 스타일과 설정의 시각적 접근법에 맞아야 합니다. 2D 일러스트 스타일에 물리적 시네마 카메라를 제안하지 마세요. 일러스트 또는 정지 이미지 스타일의 경우, 대신 일치하는 가상 카메라 움직임(푸시인, 패럴랙스, 이미지 위 팬)을 제공하고 제작이 실제로 할 수 있는 것을 말하세요.
  • visual-bible.md의 스타일 블록과 모순되지 마세요. 필름 스타일은 그 위에 추가됩니다.
  • 각 제안을 스토리(분위기, 배경, 시대, 장르)와 연결하세요.
  • 평이한 단어를 사용하세요. 용어를 처음 사용할 때는 설명하세요.
  • 각 그룹으로 넘어가기 전에 사용자의 선택을 물어보세요. 사용자가 "당신이 결정하세요"라고 말하면 추천 옵션을 선택하고 무엇을 선택했는지 알리세요.

3단계: 필름 스타일 확인 및 저장

  1. 전체 필름 스타일을 하나의 요약으로 보여주세요: 말하기 모드, 카메라 및 포맷, 렌즈, 움직임, 조명, 색상, 페이싱, 전환, 그리고 비주얼 바이블에서 복사한 아트 스타일 블록.
  2. 사용자에게 확인하거나 항목을 변경하도록 요청하세요.
  3. 명시적인 승인 시 references/film-style-template.md를 사용하여 film-style.md를 작성하세요.
  4. 또한 ~/.long-video/film-styles/<preset-name>.md에 재사용 가능한 프리셋으로 저장할 것을 제안하세요. 소문자, 숫자, 하이픈을 사용하세요. 사용자가 거절하면 건너뜁니다.

이제 필름 스타일은 확정되었습니다. 스크립트를 작성하는 동안 묻지 않고 변경하지 마세요.

4단계: 스크립트 작성

references/script-format.md를 읽고 그 형식과 타이밍 규칙을 따르세요.

규칙:

  • 설정과 일치시킵니다: 언어, 목표 길이, 화면 비율, 대상, 톤, 자막, 음성 해설 모드.
  • 승인된 스토리에 충실하세요. 모든 비트를 포함하세요. 스토리에 없는 사실, 사건 또는 주장을 추가하지 마세요. 스토리가 내레이션 텍스트(예: long-video-story-questions에서 제공된)인 경우, 그 텍스트를 그대로 유지하고 그 주변에 구조를 추가하세요.
  • 스토리를 장면으로 나누고, 각 장면을 샷으로 나누세요. 각 샷은 지속 시간, 그림, 카메라(크기, 각도, 움직임), 조명, 사운드, 전환을 포함합니다.
  • 클립 길이 제한. 각 샷(하나의 그림 또는 클립)은 최대 10초를 넘지 않습니다. 5초에서 8초를 목표로 하세요. 설정된 경우 video.max_clip_seconds와 video.preferred_clip_seconds를 설정에서 읽으세요. 기본값: 최대 10, 권장 5~8. 5초 미만의 샷은 이유가 있는 경우(빠른 삽입, 충격의 비트)에만 허용됩니다. 최대값을 초과하지 마세요. 한 순간에 제한보다 더 많은 시간이 필요한 경우, 문장, 절 또는 동작 경계에서 연속 클립(샷)으로 나누세요. 클립은 동일한 환경, 카메라 및 조명을 공유할 수 있으며, 그림은 동일하게 유지되거나 동일한 동작을 계속할 수 있습니다. 최종 결과는 단일 클립보다 깁니다. 각 후속 클립에 Continues: <이전 샷 ID>를 표시하고 내레이션이나 대사를 그대로 유지하세요. 추가 클립을 채우기 위해 새로운 카메라 움직임이나 새로운 그림을 만들지 마세요.
  • 모든 샷에 필름 스타일을 적용하세요. 확정된 스타일 내에서 리듬을 위해 샷 크기와 움직임을 다양화하세요.
  • 모든 캐릭터, 환경 및 객체에 대해 비주얼 바이블의 엔티티 ID를 사용하세요. 샷에 바이블에 없는 것이 필요한 경우, 자동으로 생성하지 말고 "필요한 새 에셋" 아래에 나열하세요.
  • 내레이션: 설정의 언어로 텍스트를 작성하세요. 대화: CHARACTER: line 형식으로 작성하고, 중요한 경우 괄호 안에 전달 노트를 추가하세요. 각 대사는 한 숨에 말할 수 있도록 유지하세요.
  • 런타임을 합산하세요. 목표 길이의 10% 이내여야 합니다. 그렇지 않은 경우 보여주기 전에 조정하세요.

5단계: 검토

  1. 요약 테이블을 보여주세요: 장면 번호, 제목, 런타임, 샷 수, 말하기 모드. 총 런타임을 목표와 비교하여 보여주세요.
  2. 첫 번째 장면을 전체적으로 보여주세요. 요청 시 다른 장면도 제공하세요.
  3. "필요한 새 에셋"을 나열하세요.
  4. 사용자에게 승인하거나 변경을 요청하도록 요청하세요.
  5. 변경 사항을 적용하세요. 사용자가 변경을 요청하지 않는 한 필름 스타일을 유지하세요. 필름 스타일이 변경되면 film-style.md를 업데이트하고 모든 샷을 다시 확인하세요.
  6. 사용자가 명시적으로 승인할 때까지 반복하세요. 침묵 또는 "지금까지 괜찮아 보인다"는 승인이 아닙니다. 불확실한 경우 "이 스크립트를 확정할까요?"라고 물어보세요.

스크립트를 보여주기 전에 다음 자체 점검을 실행하고 실패를 수정하세요:

  • 총 런타임이 목표의 10% 이내입니다.
  • 모든 스토리 비트가 스크립트에 나타납니다.
  • 모든 샷에 지속 시간, 카메라, 조명, 사운드가 있습니다.
  • 어떤 샷도 클립 제한(기본 10초)보다 깁니다. 대부분의 샷이 권장 범위(5~8초)에 있습니다. 범위를 벗어난 샷의 개수를 보고하세요.
  • 모든 엔티티 ID가 비주얼 바이블에 존재하거나 새 에셋 아래에 나열되어 있습니다.
  • 언어가 설정과 일치합니다.
  • 필름 스타일이 배제하는 카메라 움직임이나 조명을 사용한 샷이 없습니다.

6단계: 저장

  1. 형식 참조의 헤더, 상태 approved, 승인 날짜와 함께 video-script.md를 작성하세요.
  2. film-style.md가 저장되었는지 확인하세요.
  3. project.json을 업데이트하세요: "stage": "script-approved", "film_style": "film-style.md", "script": "video-script.md".
  4. 사용자에게 두 파일 경로와 총 런타임을 알려주세요. 필요한 새 에셋이 있으면 말하고 long-video-assets 실행을 제안하세요.
  5. long-video-keyframes(각 장면의 시작 및 끝 프레임 이미지)로 계속할 것을 제안하세요. 사용자가 동의하는 경우에만 시작하세요. 사용자가 요청하고 해당 단계가 존재하지 않는 한 다른 이후 단계를 시작하지 마세요.

규칙

  • 필름 스타일이 확인되기 전에는 스크립트를 작성하지 마세요.
  • 명시적인 승인 없이 스크립트를 승인하지 마세요.
  • 스토리를 변경하지 마세요. 스토리에 문제가 있으면 사용자에게 알리고 long-video-story를 다시 열 것을 제안하세요.
  • 사용자의 시각적 접근법으로 제작이 구현할 수 없는 스타일을 제안하지 마세요.
  • 채팅 메시지는 짧게 유지하세요. 전체 텍스트는 파일에 넣으세요.

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-story

Agree on the story for a long video. The user either supplies a story or asks Claude to write one. When Claude writes, it first asks which story style to use (for example niche discovery, or a provocative-questions narration), runs that style's skill, and revises until the user approves. Use after long-video-setup, or when the user says "story for my video", "give me an idea", or wants to change an unapproved story. Ends only when the user explicitly approves the story.

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

관련 스킬