Communitygithub.com

long-video-keyframes

승인된 비디오 스크립트의 모든 장면(클립)에 대해 시작 프레임과 종료 프레임 이미지를 생성합니다. 장면 번호와 시작/종료를 포함한 고정 파일명으로 각 프레임에 대한 이미지 프롬프트를 작성하고, 이미지를 위한 폴더를 만든 후 사용 가능한 이미지 도구로 이미지를 생성하거나 프롬프트를 한 번에 또는 하나씩 사용자에게 전달합니다. long-video-director 이후 또는 사용자가 시작 프레임, 종료 프레임, 키프레임 또는 장면 이미지를 요청할 때 사용합니다.

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

이 스킬은 긴 비디오 워크플로우의 5단계로, 승인된 스크립트의 각 장면에 대해 고품질 시작 및 종료 프레임 프롬프트와 이미지를 생성합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트를 지원하며, CLI 기반 프로젝트 관리와 이미지 생성 방법을 자동화합니다. 주요 기능으로는 장면 번호 매기기, 연속 클립 처리, 시각적 성경과 영화 스타일을 기반으로 한 자체 완결적 프롬프트 작성, 일괄 파일 저장, 이미지 생성(사용자 선택 시), 상태 추적이 포함됩니다. 이 스킬은 장면 전환의 연속성을 보장하고, 참조 이미지를 활용하며, 생성된 프레임이 기존 스타일과 일치하도록 합니다. 또한 프롬프트 전용, 이미지 생성, 또는 둘 다 등 다양한 전달 방식을 지원하며, 사용자가 프롬프트를 한 번에 또는 하나씩 받을 수 있습니다.

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

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

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

문서

Long video keyframes

롱 비디오 워크플로우의 5단계. 결과물: 각 장면의 시작 프레임과 종료 프레임에 대한 이미지 프롬프트, frames/ 폴더, 그리고 선택적으로 완성된 이미지.

이 단계에서 장면은 스크립트의 한 클립(한 컷, 최대 10초)을 의미합니다. 장면은 전체 비디오에 걸쳐 순서대로 번호가 매겨집니다.

시작하기 전에

  1. ~/.long-video/projects/<slug>/에서 프로젝트를 찾습니다. status: approved인 video-script.md가 필요합니다. 승인되지 않은 경우 중단하고 long-video-director를 실행합니다.
  2. film-style.md와 visual-bible.md가 필요합니다. 이 파일에는 카메라 및 조명 스타일과 고정된 아트 스타일이 포함되어 있습니다.
  3. 프로젝트 설정을 로드합니다: 종횡비, 해상도, 이미지 제공자, 승인 수준, 예산.
  4. images/에서 long-video-assets의 캐릭터, 환경 및 오브젝트 이미지를 확인합니다. 이들은 참조 자료 역할을 합니다. 없는 경우 그렇게 알립니다. 사용자가 참조 없이 프롬프트 작성에 동의하는 경우에만 계속 진행합니다.
  5. frames/ 또는 frame-prompts/가 이미 존재하는 경우, 계속할지(완료된 내용을 나열) 또는 다시 시작할지 묻습니다.

1단계: 장면 번호 매기기

  1. 스크립트를 순서대로 읽습니다. 모든 컷에 장면 번호(1, 2, 3, ...)를 비디오 전체에 걸쳐 부여합니다. 3자리로 패딩(scene-001)하거나, 999개를 초과하는 경우 4자리로 패딩합니다.
  2. 장면 번호에서 스크립트 컷 ID로의 매핑을 구축합니다(예: 장면 7은 스크립트 컷 2.3).
  3. 연속 클립을 표시합니다(스크립트의 Continues:). 이 경우 시작 프레임은 이전 장면의 종료 프레임입니다. 새 시작 프롬프트를 작성하지 않습니다. 인덱스는 이전 종료 이미지를 가리킵니다.
  4. 이미지 수를 계산합니다: 장면당 2개에서 재사용된 시작 프레임을 뺀 수입니다. 사용자에게 총계를 알립니다.

2단계: 프레임 프롬프트 작성

references/frame-prompt-templates.md를 읽습니다. 장면당 두 개의 프롬프트를 작성합니다(연속 장면의 경우 하나).

각 프레임에 대해 스크립트 컷에서 다음을 파악합니다:

  • 시작 프레임. 클립의 첫 프레임이 보여주는 것: 첫 카메라 위치, 캐릭터의 시작 포즈와 위치, 그 순간의 조명.
  • 종료 프레임. 마지막 프레임이 보여주는 것: 카메라가 이동한 위치(예: 푸시인 후 더 타이트하게), 액션이 어떻게 끝났는지, 조명의 변화. 시작 프레임에서 컷의 지속 시간 내에 도달할 수 있어야 합니다. 카메라가 정적이고 움직임이 없으면 종료 프레임은 약간의 자연스러운 변화(제스처, 조명 변화)가 있는 동일한 구도입니다.
  • 두 프레임은 카메라가 움직이지 않는 한 동일한 장소, 캐릭터 및 오브젝트를 동일한 카메라 설정으로 보여줍니다.

모든 프롬프트에 대한 규칙:

  1. 자체 완결적. "위와 동일" 사용 금지. 생성기가 필요한 모든 것을 포함합니다.
  2. 스타일 블록 그대로. visual-bible.md의 스타일 블록과 부정 용어를 정확히 복사합니다. 영화 스타일의 "생성기를 위한 프롬프트 라인"을 추가합니다. 컷의 카메라, 렌즈 및 조명을 추가합니다.
  3. 엔티티 설명 그대로. 시각적 성경의 각 캐릭터, 환경 및 오브젝트 설명을 복사합니다. 절대 의역하지 않습니다.
  4. 참조. 첨부할 이미지 파일을 나열합니다: 캐릭터 이미지 및 시트, 환경 이미지, 오브젝트. 종료 프레임의 경우 장면의 자체 시작 프레임을 첫 번째 참조로 나열합니다. 정확한 파일 이름을 사용합니다.
  5. 동일한 프레이밍. 모든 프롬프트에서 설정의 종횡비를 사용합니다.
  6. 그림 속 텍스트 금지. 스토리에 필요한 경우가 아니면 캡션, 자막, 로고 또는 읽을 수 있는 텍스트가 있는 표지판을 넣지 않습니다.
  7. 실제 인물 이름, 상표 또는 살아있는 아티스트 이름을 사용하지 않습니다.

프롬프트를 frame-prompts/에 20개 장면씩 배치 파일로 저장합니다: scenes-001-020.md, scenes-021-020.md 등. 또한 frame-prompts/index.md를 작성합니다(템플릿에 있는 형식).

3단계: 파일 이름 및 폴더

프로젝트 폴더에 frames/를 생성합니다. 다른 곳에는 절대 이미지를 넣지 않습니다.

파일 이름은 고정되어 있으며 모든 프롬프트의 헤더에 나타납니다:

  • scene-<number>_start.png
  • scene-<number>_end.png

예: scene-007_start.png, scene-007_end.png. 모든 확장자(png, jpg, webp)가 작동하지만 기본 이름은 일치해야 합니다. 이름에는 장면 번호와 시작 또는 종료라는 단어가 포함되어 있어 모든 프레임을 이름으로 찾을 수 있고 순서대로 정렬됩니다.

4단계: 사용자에게 원하는 것 묻기

묻습니다: "이 단계에서 원하는 것은 무엇입니까?"

  • 프롬프트만. 사용자가 자신의 도구로 이미지를 만듭니다.
  • 이미지. Claude가 이미지를 생성합니다.
  • 둘 다. 사용자가 프롬프트를 받고 Claude도 이미지를 생성합니다.

프롬프트 파일은 항상 저장됩니다. 이 선택은 누가 이미지를 만들지 결정합니다.

그런 다음 전달 방법을 묻습니다: 한 번에 또는 하나씩.

프롬프트만

  • 한 번에. frames/와 frame-prompts/의 전체 경로를 보여줍니다. 파일 이름이 어떻게 작동하는지 한 가지 예와 함께 보여줍니다. 사용자가 배치 파일을 열고 작업합니다. 나중에 폴더를 확인하겠다고 제안합니다.
  • 하나씩. 채팅에서 파일 이름과 첨부할 참조와 함께 첫 번째 프롬프트를 보여줍니다. 사용자가 저장했다고 말할 때까지 기다립니다. frames/에 올바른 이름의 파일이 존재하는지 확인합니다. 그런 다음 다음 프롬프트를 보여줍니다. 사용자가 "건너뛰기" 또는 "중지"라고 말하면 frames/status.md에 위치를 저장하고 중지합니다.

사용자가 요청할 때마다 또는 마지막에 폴더를 확인합니다: 인덱스와 비교하여 파일을 찾고 누락되었거나 잘못 명명된 것을 나열합니다.

이미지 또는 둘 다

../long-video-assets/references/image-generation.md를 읽고 방법 찾기, 브라우저 옵션 처리, 순서, 확인 및 상태 단계를 따릅니다. 설정에 저장된 방법이 있으면 사용합니다. 이 단계의 변경 사항:

  • 수 및 비용. 사용자에게 필요한 이미지 수와 대략적인 시간 또는 비용을 알립니다. 대량 배치를 시작하기 전에 묻습니다. 예를 들어 장면 1~10과 같은 범위부터 시작하겠다고 제안합니다.
  • 스타일 테스트. 먼저 scene-001_start를 생성합니다. 보여줍니다. 고정된 스타일과 일치하는지, 캐릭터의 외관이 맞는지 묻습니다. 계속하기 전에 프롬프트를 수정합니다.
  • 순서. 각 장면에 대해: 시작 프레임, 그 다음 종료 프레임(종료 프레임은 방법이 지원할 때 시작 프레임을 참조로 사용합니다). 그런 다음 다음 장면.
  • 참조. 프롬프트에 나열된 캐릭터, 환경 및 오브젝트 이미지를 첨부합니다. 방법이 하나의 참조만 허용하면 가장 중요한 것(프레임의 주요 캐릭터)을 사용하고 그렇게 말합니다.
  • 한 번에 또는 하나씩. 한 번에: 전체 범위를 생성한 다음 결과를 보여줍니다. 하나씩: 각 쌍을 보여주고 승인 또는 재작업 요청을 기다린 후 계속합니다.
  • 브라우저 옵션. 에셋 단계와 동일한 규칙: 먼저 수, 시간 및 다운로드 폴더에 대한 명시적 확인. 절대 비밀번호를 입력하거나 CAPTCHA를 해결하지 않습니다.
  • 확인. 각 이미지 후에 주제, 스타일 일치, 참조에 대한 캐릭터 외관, 시작 프레임과 종료 프레임 간의 차이를 확인합니다. 최대 2회 재시도 후 needs-manual로 표시합니다.
  • 절대 덮어쓰지 않음. 묻지 않고 기존 프레임을 덮어쓰지 않습니다.

생성에 실패하거나 사용자가 거부하면 나머지 장면에 대해 프롬프트 전용 경로로 대체합니다.

5단계: 상태 및 완료

  1. frames/status.md를 최신 상태로 유지합니다:
| 장면 | 프레임 | 파일 | 상태 | 비고 |
|-----|-------|------|------|------|
| 001 | 시작 | scene-001_start.png | 완료 | |
| 001 | 종료 | scene-001_end.png | 대기 | |

상태 값: 대기, 완료, 수동-필요, 건너뜀.

  1. project.json 업데이트: 프롬프트가 저장된 후 "stage": "frames-prompts-done", 모든 프레임이 존재하고 사용자가 승인한 후 "stage": "frames-images-done".
  2. 사용자에게 frames/와 frame-prompts/의 경로와 아직 누락된 내용을 알립니다.
  3. long-video-clips(프레임에서 비디오 클립 생성 또는 건너뛰고 이미지만 사용)로 계속할 것을 제안합니다. 사용자가 동의하는 경우에만 시작합니다. 사용자가 요청하고 해당 단계가 존재하지 않는 한 다른 이후 단계를 시작하지 않습니다.

프롬프트 저장 전 자체 확인

  • 모든 장면에 종료 프롬프트가 있습니다. 모든 비연속 장면에 시작 프롬프트가 있습니다.
  • 모든 프롬프트의 헤더에 파일 이름이 있으며 명명 규칙과 일치합니다.
  • 모든 프롬프트에 스타일 블록, 부정 용어 및 영화 프롬프트 라인이 그대로 포함되어 있습니다.
  • 컷의 모든 캐릭터, 환경 및 오브젝트가 설명 그대로 나타나며 참조 파일이 나열되어 있습니다.
  • 장면의 시작 및 종료 프레임이 장소, 캐릭터 및 조명에 대해 일치하며 컷이 지시하는 방식으로 다릅니다.
  • 프롬프트 수가 사용자에게 약속된 수와 일치합니다.

규칙

  • 승인된 스크립트 없이 절대 시작하지 않습니다.
  • 사용자가 "이미지" 또는 "둘 다"를 선택하기 전에 절대 이미지를 생성하지 않습니다.
  • 프롬프트가 승인된 후에는 이미지 또는 프롬프트 파일 이름을 절대 변경하지 않습니다.
  • 채팅에서 API 키를 절대 요청하지 않습니다.
  • 채팅 메시지는 짧게 유지합니다. 전체 프롬프트 텍스트는 파일에 넣고 샘플이나 현재 프롬프트만 표시합니다.

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

관련 스킬