Communitygithub.com

long-video-render

완성된 비디오를 조립하고 검토 루프를 실행합니다. 클립(또는 카메라 움직임이 있는 이미지), 음성, 사운드 스템 및 자막을 사용하여 편집본을 제작하고, 클라이언트가 검토할 수 있도록 장면 번호와 시간이 표시된 저화질 검토 버전을 렌더링하며, 변경 사항을 수집 및 적용(필요에 따라 검토 버전을 재렌더링)하고, 사용자가 승인하면 고화질 최종 비디오를 렌더링합니다. 가능하고 사용자가 원하는 경우 CLI 또는 MCP(FilmCraft, EffectCraft 등)가 있는 비디오 편집기를 사용하고, 그렇지 않으면 번들된 ffmpeg 렌더러를 사용합니다. long-video-sound 이후 또는 사용자가 비디오 렌더링, 조립, 내보내기, 미리보기 또는 최종 제작을 요청할 때 사용합니다.

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

이 스킬은 긴 비디오 워크플로우의 최종 단계(9단계)로, 승인된 스크립트와 생성된 클립, 이미지, 음성, 사운드 스템 및 자막을 결합하여 하나의 완성된 비디오 파일로 만듭니다. 먼저 각 장면의 자산(클립, 이미지, 음성, 사운드)을 점검하고 누락된 항목을 보고한 후, 편집 결정 목록(EDL)을 JSON 형식으로 생성합니다. 이후 저화질 검토 버전을 렌더링하여 장면 번호와 시간을 비디오 상단에 표시하고, 클라이언트 피드백을 수집하여 변경 사항을 적용한 후 다시 렌더링하는 반복 과정을 거칩니다. 마지막으로 사용자가 특정 검토 버전을 '최종'이라고 명시하면 프레임과 오디오 품질을 최적화한 고화질 최종 비디오를 렌더링하고 프로젝트 상태를 업데이트합니다. 이 스킬은 번들된 ffmpeg 렌더러를 기본으로 사용하지만, FilmCraft나 EffectCraft 같은 편집 도구가 연결된 경우 사용자 선택에 따라 해당 도구로도 동일한 작업을 수행할 수 있습니다.

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

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

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

문서

긴 비디오 렌더링

긴 비디오 워크플로우의 9단계. 출력물: 사용자가 승인할 때까지의 검토 렌더(저화질), 이후 고화질 최종 비디오 한 개.

장면은 이전 단계에서와 같이 비디오 전체에 걸쳐 순서대로 번호가 매겨진 스크립트의 한 클립을 의미합니다. 검토 비디오에 장면 번호가 표시되어 검토자가 가리킬 수 있습니다.

시작하기 전에

  1. ~/.long-video/projects/<slug>/에서 프로젝트를 찾으세요. status: approved인 video-script.md가 필요합니다.
  2. 프로젝트 설정을 로드하세요: 해상도, 화면 비율, 자막 모드(visuals.captions), 음량 요구 사항, 플랫폼.
  3. ffmpeg와 ffprobe를 확인하세요(ffmpeg -version). 번들 렌더러는 libx264와 libass가 있는 ffmpeg가 필요합니다.
  4. render/가 이미 존재하는 경우, 계속할지(버전 목록 표시) 아니면 다시 시작할지 물어보세요.

1단계: 인벤토리

모든 장면을 확인하고 존재하는 항목을 나열하세요:

항목위치사용 용도
비디오 클립clips/scene-<NNN>_clip.* (또는 _take2 등 사용자가 승인한 버전)해당 장면의 영상
이미지만frames/scene-<NNN>_start.*스크립트의 카메라 움직임(확대, 축소, 패닝)이 있는 정지 이미지
음성audio/lines/scene-<NNN>_<speaker>_<NN>.*내레이션 및 대화
사운드 스템sound/mix/sfx_track.wav, amb_track.wav, music_track.wav효과음, 분위기, 음악

짧은 표로 누락된 항목을 보고하세요. 클립도 없고 이미지도 없는 장면은 차단 요소입니다: 해당 장면을 나열하고 long-video-keyframes 또는 long-video-clips으로 돌아갈 것을 제안하세요. 음성이나 사운드가 누락된 것은 사용자가 해당 단계를 건너뛰기로 선택한 경우에만 허용됩니다. 단계가 건너뛰어졌다면 다시 요청하지 마세요.

클립 단계가 건너뛰어진 경우(clips_mode: images-only), 모든 장면은 스크립트 샷에서 가져온 카메라 움직임이 있는 정지 이미지가 됩니다.

2단계: 조립 도구 선택

  1. Claude가 제어할 수 있는 비디오 편집기가 있는지 확인하세요: 이 세션에 연결된 편집 MCP 서버 또는 장치의 CLI(FilmCraft: filmcraft-cli commands; EffectCraft: effectcraft-cli --help). ../long-video-sound/references/tools.md의 섹션 5를 참조하세요.
  2. 사용 가능한 편집기가 있다면, 사용할지(사용자가 프로젝트를 열고 조정할 수 있음) 아니면 번들 렌더러를 사용할지 물어보세요. 기본값은 번들 렌더러입니다. 사용자가 편집기를 선택하면 먼저 명령 목록과 문서를 읽고, 복사본에서 작업하며, 설치나 빌드 전에 먼저 물어보고, 동일한 파일 이름을 유지하세요.
  3. 어떤 도구를 사용할지 알려주세요.

이 스킬의 나머지 부분은 번들 렌더러를 설명합니다. 편집기를 사용하는 경우, 동일한 단계를 해당 명령을 통해 수행하고 검토 및 최종 파일을 동일한 폴더와 이름으로 내보내세요.

3단계: 편집 목록 빌드

references/edl-format.md를 읽으세요. 프로젝트 파일에서 render/edl.json을 작성하세요:

  • 각 장면에 대해 지속 시간(스크립트 기준 또는 실제 클립 길이가 장면 길이보다 짧거나 긴 경우 실제 길이), 영상 소스, 정지 이미지의 카메라 움직임, 전환 효과를 포함한 항목 하나씩,
  • 음성 배치: 장면 시작 시간과 짧은 오프셋(기본값 0.3초), 순서대로 작은 간격을 둔 라인,
  • 사운드 스템,
  • 설정에서 자막을 원하는 경우 음성 텍스트의 자막(각 음성 파일의 지속 시간에 따른 시작 및 종료),
  • 설정의 너비, 높이 및 fps. 기본 fps는 24입니다. 기본 음량 목표는 -14 LUFS이며 트루 피크는 -1.5 dBTP 미만입니다.

규칙:

  • 승인된 스크립트의 정확한 장면 지속 시간을 사용하세요. 스토리를 늘리거나 줄이지 마세요.
  • 장면보다 긴 클립은 끝에서 잘립니다. 장면보다 짧은 클립은 마지막 프레임을 유지합니다. 둘 다 보고하세요.
  • 장면 끝이나 비디오 끝을 넘어서는 음성 라인은 경고로 보고됩니다.
  • 전환: 기본값은 cut입니다. fade(검은색으로 페이드)는 스크립트에 명시된 경우에만 사용합니다. 크로스 디졸브는 편집 도구가 필요합니다.
  • 렌더링 전에 계획을 확인하세요: node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --plan.

짧은 요약을 보여주세요: 장면 수, 대상 대비 총 런타임, 클립 대 정지 이미지, 경고. 스토리를 변경하지 않고 해결할 수 있는 문제는 수정하세요. 해결할 수 없는 문제는 사용자에게 물어보세요.

4단계: 검토 버전 렌더링

검토 품질: 저해상도(약 360p), 높은 압축, 왼쪽 상단에 장면 번호와 시간 표시, 설정에서 자막이 내장(burned-in) 된 경우 자막 포함.

node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --version 1
  • 출력: render/review/<slug>_review_v1.mp4 및 지속 시간, 크기, 음량이 포함된 .report.json.
  • 장면 세그먼트는 캐시됩니다. 이후 검토에서는 변경된 장면만 다시 렌더링하므로 훨씬 빠릅니다.
  • 몇 분 이상의 비디오의 경우 명령을 백그라운드에서 실행하고 완료될 때까지 기다리세요. 폴링하지 마세요.
  • 자막 모드가 srt인 경우 비디오 옆에 .srt 파일이 작성됩니다.

보고서를 확인하세요: 실제 지속 시간과 계획된 지속 시간, 음량, 스트림. 그런 다음 사용자에게 전체 경로와 크기를 알려주세요.

검토 방법을 알려주세요: 파일을 시청하고, 각 댓글과 함께 모서리에 표시된 장면 번호와 시간을 기록하세요. Claude는 파일을 보내거나 업로드하지 않습니다. 사용자가 클라이언트와 공유합니다. 사용자가 요청하는 경우에만 업로드를 준비하겠다고 제안하고, 먼저 물어보세요.

5단계: 변경 사항 수집

"변경 사항이 있나요? 최종이라면 말씀해 주시면 고화질 버전을 렌더링하겠습니다."라고 물어보세요.

사용자는 클라이언트의 피드백을 붙여넣을 수 있습니다. references/review-feedback.md를 읽으세요. 각 댓글에 대해:

  1. 참조하는 장면 번호 또는 시간을 찾으세요. 댓글이 모호하면 짧은 질문 하나를 하세요.
  2. 분류하고 경로를 선택하세요:
    • 편집 수준(트림, 길이, 순서, 자막 텍스트, 자막 켜기/끄기, 전환, 음성, 음악 또는 효과 레벨): 여기서 edl.json 또는 스템의 게인을 수정하세요.
    • 장면의 영상(외관, 캐릭터, 구성, 움직임): 해당 장면에 대해 long-video-keyframes 또는 long-video-clips으로 돌아가세요. 새 파일은 _take2 스타일의 이름을 얻습니다. 그런 다음 편집 목록을 업데이트하세요.
    • 음성 라인(전달, 발음, 표현): 해당 라인에 대해 long-video-voice로 가세요. 승인된 스크립트에 대한 표현 변경은 사용자의 승인과 스크립트 수정이 필요합니다.
    • 사운드(효과음, 분위기, 음악): 해당 큐에 대해 long-video-sound로 가서 다시 믹스하세요.
    • 스토리 또는 구조(장면 추가 또는 제거): long-video-director로 가서 영향을 받는 장면만 하류에서 다시 작업하세요.
  3. 버전, 장면, 요청, 경로 및 상태와 함께 목록을 render/review-log.md에 작성하세요.
  4. 사용자에게 짧은 표로 계획을 보여주세요. 크레딧이나 시간이 소요되는 재생성 전에 승인을 요청하세요.
  5. 변경 사항을 적용한 후 다음 검토를 렌더링하세요(--version 2 등). 모든 이전 검토 파일을 보관하세요.
  6. 사용자에게 장면별로 변경된 내용과 새 파일 경로를 알려주세요.

사용자가 승인할 때까지 반복하세요. 침묵이나 "지금까지 괜찮아 보입니다"는 승인이 아닙니다.

6단계: 최종 비디오 렌더링

사용자가 특정 검토 버전이 최종이라고 명시적으로 말한 경우에만 진행하세요.

  1. 확인: "검토 v에서 최종 버전을 렌더링할까요?" 편집 목록이 해당 버전과 일치하는지, 검토 로그에 열려 있는 변경 요청이 없는지 확인하세요.
  2. 최종 품질: 설정의 해상도, 고품질 H.264(crf 18, slow 프리셋), AAC 192k, 대상에 대한 2패스 음량 정규화, 검토 레이블 없음. 설정에서 자막이 내장(burned-in) 된 경우에만 자막이 포함됩니다. 그렇지 않으면 .srt 파일이 작성됩니다.
  3. 실행하세요. 긴 비디오의 경우 백그라운드에서:
node <skill folder>/scripts/build-render.mjs render/edl.json final render/final
  1. 보고서와 ffprobe로 확인하세요: 지속 시간이 계획과 일치하고, 해상도와 fps가 올바르며, 비디오 스트림과 오디오 스트림이 각각 하나씩 있고, 음량이 대상 근처(약 1 LU 이내)이고 트루 피크가 -1 dBFS 미만인지 확인하세요.
  2. 선택적으로 예상치 못한 검은 프레임과 긴 무음을 확인하세요: ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. 결과를 보고하세요.
  3. project.json을 업데이트하세요: "stage": "final-rendered", "final_video": "<path>", 그리고 승인된 검토 버전.
  4. 사용자에게 전체 경로, 크기 및 지속 시간을 알려주세요. 비디오 설명을 위해 sound/credits.md의 크레딧을 상기시키세요.
  5. long-video-publish(YouTube 제목 옵션, 설명, 태그 및 썸네일 프롬프트)로 계속할 것을 제안하세요. 사용자가 동의하는 경우에만 시작하세요. 게시하거나 업로드하지 마세요. 사용자가 요청하고 해당 단계가 존재하지 않는 한 다른 이후 단계를 시작하지 마세요.

규칙

  • 특정 검토 버전에 대한 명시적인 승인 없이 최종 버전을 절대 렌더링하지 마세요.
  • 승인된 스크립트를 절대 변경하지 마세요. 피드백에 필요하다면 경로를 지정하고 물어보세요.
  • 사용자의 명확한 요청 없이 비디오를 보내거나, 공유하거나, 업로드하지 마세요.
  • 이전 검토 렌더를 절대 삭제하지 마세요.
  • 계획에 대한 사용자의 승인 없이 이미지, 클립, 음성 또는 사운드를 절대 재생성하지 마세요.
  • 채팅 메시지는 짧게 유지하세요. 변경 목록은 render/review-log.md에 작성하세요.

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-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

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-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.

관련 스킬