모션 비디오 제작이란?
모션 비디오 제작은 초기 기획부터 최종 편집까지 30~90초 길이의 모션 그래픽과 동영상을 만드는 과정을 안내하는 Claude Code 스킬입니다. 동영상 생성을 하나의 프롬프트로 처리하는 대신, 제작 과정을 6단계로 나누고 다음 작업으로 넘어가기 전에 각 단계의 결과물을 검증합니다.
저장소에는 harness/gate.py에 게이트 스크립트가 포함되어 있습니다. 각 게이트는 관련 결과물을 측정하고 종료 코드를 반환합니다. 0은 단계 통과를, 1은 결과가 차단되어 수정이 필요함을 의미합니다. 또한 프로젝트는 references/gotchas.md에 반복적으로 발생하는 제작 문제 29가지를 정리해 둡니다.
주요 기능
- 6단계 제작 워크플로: 스토리 기획, 캐릭터 디자인, 키프레임, 동영상 클립, 오디오, 최종 편집.
- 측정 가능한 품질 게이트: 스크립트가 파일, 타이밍, 프레임 수, 화면 비율, 오디오 속성 및 단계별 요구 사항을 확인합니다.
- 사람의 검토 지점: 수치 지표만으로 신뢰성 있게 판단할 수 없는 시각적 문제는 사람이 검토하고 기록해야 합니다.
- 캐릭터 일관성 가이드: 7가지 기준을 통해 장면이 바뀌어도 외형, 목소리, 립싱크, 음악 타이밍 및 전반적인 품질을 유지합니다.
- 프레임 스트립 생성: 클립 게이트가 오프닝 프레임 이후 발생하는 캐릭터 변화를 보여 주는 이미지 스트립을 만듭니다.
- 알려진 문제 참고 자료: 29개의 문제 항목에서 증상, 원인, 예방 단계 및 관련 하니스 검사 ID를 설명합니다.
- 재사용 가능한 템플릿과 스크립트: 저장소에는 중복 감지, 비트 그리드, 클립 시트, 오디오 믹싱, 먹싱 및 검증을 위한 기획 템플릿과 유틸리티가 포함되어 있습니다.
사전 요구 사항
Claude Code, Python 3, ffmpeg, ffprobe가 필요합니다.
이 저장소에는 Remotion 컴포지션 코드가 포함되어 있지 않습니다. Remotion을 별도로 설치하고 자신의 프로젝트에 필요한 컴포지션을 만드세요.
프로젝트에서 언급하는 선택적 생성 도구로는 이미지와 동영상 제작을 위한 ChatGPT 또는 Grok Imagine, 음악 제작을 위한 Suno, 음성 제작을 위한 ElevenLabs 또는 Fish Audio, 전사 기반 검토를 위한 Whisper가 있습니다. README에 따르면 verify.sh의 Whisper 통합은 검증되지 않았습니다.
Claude Code 스킬 설치
Claude Code는 ~/.claude/skills/<skill-name>/SKILL.md에서 스킬을 검색합니다. 저장소를 클론하고 skills 디렉터리를 만든 다음 전체 스킬 폴더를 복사하세요.
git clone https://github.com/unclejobs-ai/motion-video-skill.git
mkdir -p ~/.claude/skills
cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/하니스, 참고 자료, 스크립트 및 템플릿이 함께 작동하므로 전체 motion-video-production 디렉터리를 복사해야 합니다.
하나의 프로젝트에만 설치
특정 프로젝트 내부에서만 스킬을 사용할 수 있도록 하려면 전역 디렉터리 대신 해당 프로젝트의 .claude/skills/ 디렉터리에 같은 폴더를 복사하세요.
mkdir -p your-video-project/.claude/skills
cp -r motion-video-skill/skills/motion-video-production \
your-video-project/.claude/skills/스킬을 복사한 후 Claude Code를 다시 시작해야 새 SKILL.md를 검색할 수 있습니다.
하니스 검증
클론한 저장소에서 하니스 자체 테스트를 실행하세요.
bash skills/motion-video-production/harness/selftest.sh종료 코드 0은 현재 컴퓨터에서 게이트 하니스가 정상적으로 작동함을 확인해 줍니다. 테스트가 실패하면 먼저 Python 3, ffmpeg 및 ffprobe가 설치되어 있고 명령 경로에서 사용할 수 있는지 확인하세요.
동영상 프로젝트 시작
Claude Code를 열고 제작하려는 동영상을 설명하세요. 예를 들면 다음과 같습니다.
캐릭터가 등장하는 30초 오프닝 동영상을 만들고 싶어요.
제작을 시작하기 전에 Claude가 4가지 제약 조건을 묻습니다.
- 동영상을 게시하거나 배포할 방법.
- 목표 길이와 화면 비율.
- 제작에 사용할 수 있는 도구.
- 결과물에 포함되면 안 되는 요소.
이 질문에 답하면 스킬은 STORY.md에서 시작하여 각 단계를 순서대로 진행합니다.
6단계 워크플로 이해
워크플로는 STORY.md, character.txt, key/, clip/, voices.json, edit.json과 같은 결과물을 생성합니다. 각 결과물은 이후 단계의 입력으로 사용되므로, 결과가 처음 보기에는 괜찮아 보여도 단계를 건너뛰어서는 안 됩니다.
1. 스토리 및 장면 기획
story 게이트는 누락된 필드, BPM 정보, 음악 동기화 표의 숫자 형식 시간 및 장면 표를 확인합니다. 두 번째 인수로 프로젝트 디렉터리를 지정하여 실행하세요.
python3 harness/gate.py story /path/to/video-project비용이 많이 드는 미디어를 생성하기 전에 기획 오류를 해결하세요. 특히 이후 컷이 비트 그리드를 따를 수 있도록 음악 타이밍과 장면 구조를 충분히 일찍 확정해야 합니다.
2. 캐릭터 시트
character 게이트는 character.txt가 일반 텍스트로 된 하나의 문단인지, 색상 설명을 포함하는지, 그리고 필요한 캐릭터 시트 이미지가 함께 있는지 확인합니다.
python3 harness/gate.py character /path/to/video-project고정된 외형 설명과 캐릭터 시트는 이후 키프레임과 클립을 위한 공통 시각적 참조를 제공합니다.
3. 키프레임
keyframes 게이트는 중복 파일을 감지하고 클립에 필요한 화면비를 확인합니다.
python3 harness/gate.py keyframes /path/to/video-project키프레임은 단순한 계획용 이미지가 아닙니다. 생성된 비디오 클립의 예상 시작 프레임으로도 사용됩니다.
4. 비디오 클립
clips 게이트는 재생 시간, 프레임 수, 클립이 예상 키프레임으로 시작하는지를 확인합니다. 또한 프레임 스트립을 생성하고 각 클립에 대한 결정 기록을 요구합니다.
python3 harness/gate.py clips /path/to/video-project클립이 시작 부분에서는 키프레임과 일치하더라도 1~2초 후 캐릭터의 옷, 안경, 머리카락 또는 얼굴이 바뀔 수 있습니다. 따라서 게이트는 키프레임과 0초, 1.0초, 1.5초, 2.0초, 3.0초의 프레임을 포함하는 qa/strip-<clip>.png 파일을 생성합니다.
스트립을 열어 이후 프레임을 확인하고 결과를 qa/clips-review.md에 기록하세요. SSIM과 같은 유사도 지표만으로는 의도한 캐릭터 동작과 원치 않는 캐릭터 변형을 안정적으로 구분할 수 없으므로, 이후 프레임에는 사람의 판단이 필요합니다.
5. 음악과 음성
audio 게이트는 프로젝트가 하나의 음성 ID를 사용하고 필요한 대사 파일을 갖추었는지 확인합니다.
python3 harness/gate.py audio /path/to/video-project최종 컷 길이를 확정하기 전에 대사의 재생 시간을 측정하세요. 그렇지 않으면 대사가 배정된 장면 안에 자연스럽게 들어맞지 않을 수 있습니다.
6. 조립 및 최종 검토
마지막 단계에서는 edit 및 final 게이트를 모두 사용합니다. 이 검사에서는 비트 그리드, 컷 연결, 반복 컷, 대사 재생 시간, 프레임 수, 오디오 존재 여부, 음량, 트루 피크, 필수 검토 기록을 확인합니다.
python3 harness/gate.py edit /path/to/video-project
python3 harness/gate.py final /path/to/video-project완성된 작업의 시각적 검토 결과는 qa/review.md에 기록해야 합니다. 자동 측정으로 이 검토를 대신할 수는 없습니다.
게이트가 차단되었을 때 대응하는 방법
각 단계에서 동일한 수정 절차를 사용하세요.
python3 harness/gate.py <stage> <project-directory>를 실행합니다.- 프로세스 종료 코드를 확인합니다.
- 코드가
0이면 다음 단계로 진행합니다. - 코드가
1이면qa/gate-<stage>.txt를 엽니다. BLOCK으로 표시된 줄을 찾습니다.- 해당 아티팩트를 수정합니다.
- 통과할 때까지 같은 게이트를 다시 실행합니다.
python3 harness/gate.py clips project | tail과 같은 파이프라인 뒤에 명령을 숨기지 마세요. 파이프라인은 게이트의 종료 상태를 마지막 명령의 상태로 바꿀 수 있어, 실패한 게이트가 성공한 것처럼 보이게 만들 수 있습니다.
고급 제작 팁
모든 연결 지점에서 캐릭터 정체성 유지하기
프로젝트는 일곱 가지 일관성 기준을 정의합니다. 캐릭터 시트, 고정된 외형 설명, 키프레임 시작 이미지, 고정된 음성, 대사와 입 움직임, 음악 비트 정렬, 품질 검토입니다. 각 기준이 6단계 워크플로의 어디에 해당하는지 확인하려면 references/consistency-7.md를 참조하세요.
임의의 초가 아니라 비트로 컷 구성하기
음악 비트의 배수로 컷 길이를 선택하세요. 누적 타이밍을 프레임으로 변환할 때는 각 개별 구간을 반복해서 반올림하지 말고, 누적 시간에서 시작 프레임을 한 번만 반올림하세요. 이렇게 하면 타이밍 드리프트가 줄어들고 G11 및 G12 주의사항에 따른 지침을 따를 수 있습니다.
편집을 확정하기 전에 음성 측정하기
최종 컷 길이를 결정하기 전에 대사를 생성하거나 측정하세요. 이 순서를 따르면 너무 짧은 장면에 대사를 억지로 넣는 일을 방지하고 G13 주의사항을 해결할 수 있습니다.
신뢰할 수 있는 ffprobe 출력 사용하기
ICC 프로필이 포함된 비디오는 ffprobe -of csv=p=0가 30,과 같은 프레임 수를 출력하게 만들 수 있습니다. 프로젝트에서는 래퍼나 키 없이 기본 출력을 사용할 것을 권장합니다.
ffprobe -of default=nw=1:nk=1 ...필터링 중 오디오 지연 유지하기
ffmpeg를 사용할 때 adelay 이후에 apad와 atrim을 적용하면 의도한 지연이 제거될 수 있습니다. 프로젝트의 주의사항 지침에서는 이 상황에 asetpts=N/SR/TB를 사용하도록 안내합니다.
막연히 문제를 해결하기 전에 포함된 참조 자료 사용하기
단계가 반복해서 실패하거나 생성된 미디어가 예상치 않게 변경되면 skills/motion-video-production/references/gotchas.md를 여세요. 이 파일의 29개 항목에는 각각 증상, 예상 원인, 예방 조치, 관련 하네스 검사 ID가 기록되어 있습니다.
알아둘 만한 저장소 구성 요소
SKILL.md에는 Claude Code 스킬 지침이 들어 있습니다.harness/gate.py는 단계별 통과 또는 차단 검사를 수행합니다.harness/selftest.sh는 하네스 설치를 검증합니다.scripts/에는 중복 검사, 클립 시트 생성, 키 플레이트, 비트 그리드 생성, 믹싱, 먹싱, 검증 유틸리티가 포함되어 있습니다.templates/에는 스토리, 캐릭터 시트, 프롬프트, 장면 감사용 템플릿이 포함되어 있습니다.references/에는 일관성 지침, 비트 그리드 정보, 비용 규칙, 도구 참고 사항, 라이선스 정보, 제작 주의사항이 들어 있습니다.NOTICE.md는 외부 도구 관련 고려 사항을 요약합니다.
라이선스 및 책임
저장소 자체는 MIT 라이선스를 사용하지만, 외부 생성 도구에는 각각 고유한 가격, 사용 및 상업적 라이선스 조건이 적용됩니다. NOTICE.md와 references/licensing.md를 검토한 후, 가격과 정책은 변경될 수 있으므로 프로덕션에 사용하기 전에 현재 약관을 직접 확인하세요. 생성된 에셋에 대한 책임은 해당 고지 및 외부 약관의 적용을 받습니다.
결론
Motion Video Production은 짧은 형식의 동영상 제작을 반복 가능하고 테스트 가능한 워크플로로 전환합니다. 핵심 가치는 단일 생성 도구가 아니라 기획, 캐릭터 레퍼런스, 키프레임, 클립, 사운드, 최종 편집을 연결하는 체계적인 순서에 있습니다. 게이트 검증 실패를 건너뛰지 않고 수정 작업으로 처리하며 필수 시각 검토를 완료하면, 연속성, 타이밍 및 납품 관련 문제를 완성된 동영상에 반영되기 전에 발견할 수 있습니다.