
Motion Video Kit이란?
Motion Video Kit은 실제 비즈니스를 위한 프리미엄 출시 스타일 광고를 제작하는 Claude Code 스킬입니다. AI 생성 영상, HTML과 GSAP로 구현한 모션, 선택적인 Three.js 장면, 측정 가능한 품질 검사, 독립적인 검토 프로세스를 결합합니다.
이 키트는 다른 대규모 언어 모델에서 일반 컨텍스트로도 사용할 수 있습니다. 가이드는 28편의 전문 SaaS 출시 영상 분석과 독립적인 비평을 다섯 차례 거쳐 개선한 샘플 광고를 바탕으로 합니다. 저장소에는 원본 분석과 참고 영상 링크가 포함되어 있지만, 해당 영상의 푸티지를 재배포하지는 않습니다.
Motion Video Kit은 렌더링에 HyperFrames를 사용할 때 가장 효과적이지만, 원칙과 프롬프트, 품질 검사는 렌더러에 종속되지 않습니다.
주요 기능
- Gauntlet 검토 루프: 제작자와 심사자를 분리하고, 새로운 비평가를 통해 실제 렌더를 평가하며, 발견 사항을 항목별로 검증하고 작업 내용을 원장에 기록합니다.
- 모션 문법: 6가지 모션 규칙, 재사용 가능한 16가지 메커니즘 카탈로그, 페이싱 가이드, 28편의 참고 영상에 대한 메모를 제공합니다.
- 품질 관리: 정지 시간, 음량, 대비, 브랜드 색상과 같은 측정 가능한 검사와 시각적 및 비즈니스 승인 기준을 함께 다룹니다.
- 오디오 가이드: 구매자의 고객에게 맞는 음악을 선택하고, 절제된 음향 효과를 사용하며, 정의된 믹스 목표를 달성하는 방법을 설명합니다.
- 비즈니스 플레이북: 구매 근거가 포함된 광고 분야, 가격 기준점, 파일럿 제안 템플릿, 정직성 규칙을 제공합니다.
- Three.js 패턴: 결정론적이고 탐색 가능한 장면, 투영 콜아웃이 있는 분해 레이어, 3D 컨텍스트에 배치한 사진, 애니메이션 옵션 패치, 사실성 체크리스트를 문서화합니다.
- 스크립트와 템플릿: 정지 시간 측정, 음량 분석, 콘택트 시트 생성, 음향 효과 완화, 후보 선택, 게인 계산, 격리된 컴포넌트 테스트, 투영 오버레이를 위한 유틸리티를 포함합니다.
사전 요구 사항
포함된 스크립트를 사용하려면 ffmpeg와 ffprobe가 필요합니다. 음량 분석을 위해 FFmpeg 설치에 ebur128 필터가 포함되어 있어야 합니다.
Node.js 22 이상과 HyperFrames는 선택 사항입니다. 포함된 component-lab 템플릿을 사용할 때 유용하지만, 프로젝트의 워크플로, 프롬프트 또는 검토 기준을 적용하는 데 필수는 아닙니다.
필수 도구 확인
ffmpeg -version
ffprobe -version
ffmpeg -filters음량 측정 도구를 사용하기 전에 필터 출력을 검토하고 ebur128을 사용할 수 있는지 확인하세요.
Claude Code에 Motion Video Kit 설치
1단계: 저장소 복제
git clone https://github.com/echris6/motion-video-kit.git2단계: 스킬을 전역 또는 로컬에 설치
모든 Claude Code 프로젝트에서 스킬을 사용할 수 있게 하려면 사용자 수준 스킬 디렉터리에 복사하세요.
cp -r motion-video-kit/business-motion-film ~/.claude/skills/한 프로젝트에서만 사용하려면 해당 프로젝트의 로컬 스킬 디렉터리에 복사하세요.
cp -r motion-video-kit/business-motion-film <your-project>/.claude/skills/설치한 후 Claude Code에 비즈니스 광고, 샘플 릴 또는 설명 영상 제작을 요청하세요. 기존 영상을 제공하고 검토를 요청할 수도 있습니다.
다른 LLM에서 키트 사용
이 프로젝트는 Claude Code에만 국한되지 않습니다. 다른 LLM에서 사용하려면 business-motion-film/SKILL.md의 내용을 모델 컨텍스트에 넣은 다음, 작업과 관련된 참고 파일만 추가하세요.
예를 들어 전환과 페이싱을 설계할 때는 motion-grammar.md를, 사운드트랙을 계획할 때는 audio.md를, 렌더링된 영상을 평가할 때는 critic-prompts.md를 포함하세요. 이렇게 선택적으로 구성하면 프로젝트의 핵심 규칙을 유지하면서 컨텍스트를 집중시킬 수 있습니다.
저장소 구조 이해
business-motion-film/
SKILL.md
references/
gauntlet.md
critic-prompts.md
motion-grammar.md
launch-film-notes.md
quality-bar.md
audio.md
business-offers.md
three-js-patterns.md
case-study-alder.md
scripts/
templates/
component-lab.html
projected-overlays.jsSKILL.md는 주요 워크플로와 반드시 지켜야 할 요구 사항을 정의합니다. references 디렉터리에는 제작, 비즈니스, 모션, 오디오, Three.js, 검토에 관한 상세 가이드가 들어 있습니다. scripts 디렉터리에는 측정 및 미디어 처리 유틸리티가 있으며, templates에는 격리된 컴포넌트 랩과 투영 오버레이 모듈이 제공됩니다.
첫 광고 제작
1단계: 비즈니스와 결과물 정의
구체적인 브리핑으로 시작하세요. 실제 비즈니스, 홍보할 제품 또는 서비스, 대상 고객, 결과물이 광고인지 샘플 릴인지 설명 영상인지 파악하세요.
처음 요청할 때는 다음과 같이 작성할 수 있습니다.
이 비즈니스를 위한 출시 스타일 광고를 제작하세요. Motion Video Kit을 사용해 비주얼 방향, 모션 계획, 오디오 접근 방식, 제작 워크플로, 품질 검토 계획을 수립하세요.
가능하면 실제 브랜드 자산, 승인된 메시지, 제품 정보를 제공하세요. 모델에 고객 성과를 조작하거나 생성된 인물과 장소를 실제 증거인 것처럼 묘사하도록 요청하지 마세요.
2단계: 장면을 만들기 전에 모션 계획
references/motion-grammar.md를 사용해 모션 메커니즘을 선택하고 속도감을 설정하세요. 이 키트는 6가지 핵심 규칙과 재사용 가능한 16가지 메커니즘을 제공하므로, 임의로 움직임을 추가하는 대신 의도적으로 선택할 수 있습니다.
스타일 참고 자료가 필요하다면 references/launch-film-notes.md를 확인하세요. 이 파일에는 28편의 오리지널 필름에 대한 서면 관찰과 링크가 포함되어 있습니다. 이 노트는 분석과 연출을 위한 자료로 사용하세요. 저장소는 참조된 영상의 재사용 권한을 부여하지 않습니다.
3단계: 각 샷의 제작 기법 선택
장면의 필요에 따라 여러 기법을 조합하세요.
- 독창적인 시각 자료가 필요할 때는 AI 생성 영상을 사용하세요.
- 정밀한 코드 기반 모션에는 HTML과 GSAP를 사용하세요.
- 공간 레이어, 3D 맥락, 투영 콜아웃 또는 옵션 패치가 효과적인 콘셉트에는 Three.js를 선별적으로 사용하세요.
- 전체 필름에 통합하기 전에 독립 컴포넌트 랩을 사용해 개별 컴포넌트를 다듬으세요.
모든 샷에 Three.js를 기본값처럼 적용하지 마세요. 저장소는 이를 선별적인 도구로 제시하며, 기술적으로는 인상적이지만 시각적으로 설득력이 떨어지는 결과를 방지할 수 있도록 사실성 체크리스트를 제공합니다.
4단계: 사운드트랙 설계
음악, 음향 효과, 믹스 레벨을 선택할 때는 references/audio.md를 참고하세요. 단지 유행하는 느낌이 든다는 이유로 트랙을 선택하지 말고 구매자의 고객에게 음악을 맞추세요. 음향 효과는 드물고 깔끔하게 사용해 믹스를 복잡하게 만들지 않으면서 중요한 움직임을 강화하도록 하세요.
포함된 스크립트는 음향 효과를 완화하고, 후보를 식별하고, 게인을 조정하고, 라우드니스를 측정하는 데 도움을 줄 수 있습니다. README에는 각 스크립트의 명령줄 옵션이 정해져 있지 않으므로, 실행하기 전에 관련 스크립트를 확인하고 문서화된 인터페이스를 따르세요.
5단계: 렌더링 및 측정
스토리보드나 소스 코드만 보고 판단하지 말고 실제 출력물을 검토하세요. 제공된 도구와 품질 기준 안내를 사용해 다음 항목을 확인하세요.
- 정지되었거나 시각적으로 비활성인 시간.
- 오디오 라우드니스.
- 대비와 가독성.
- 브랜드 색상의 올바른 사용.
- 시각적 완성도와 비즈니스 적합성.
콘택트 시트를 사용하면 완성된 필름 전체에서 속도감, 구성, 시각적 반복, 취약한 프레임을 더 쉽게 검토할 수 있습니다.
Gauntlet 품질 루프 실행
Gauntlet은 Motion Video Kit의 핵심 요소입니다. 핵심 원칙은 빌더와 심사자는 같지 않다는 것입니다. 필름을 제작한 사람이나 모델이 완성 여부를 판단하는 유일한 주체가 되어서는 안 됩니다.
- 현재 버전 렌더링: 설명이나 의도된 동작에 의존하지 말고 실제 필름을 비평자에게 제공하세요.
- 새로운 비평자 활용: 해당 작품 제작을 담당하지 않은 평가자로부터 리뷰를 받으세요.
- 발견 사항 기록: 문제, 결정 사항, 변경 사항의 장부를 유지하세요.
- 필름 수정: 렌더와 프로젝트 품질 기준으로 뒷받침되는 문제를 해결하세요.
- 각 항목 검증: 주장된 모든 수정 사항이 새 렌더에서 보이거나 측정되는지 개별적으로 확인하세요.
- 필요에 따라 반복: 필름이 측정 기준, 시각 기준, 비즈니스 출시 기준을 충족할 때까지 계속하세요.
컴포넌트 리뷰, 전체 필름 리뷰, 검증, 스토리보드 비평을 위한 즉시 사용 가능한 프롬프트는 references/critic-prompts.md에서 확인할 수 있습니다. references/case-study-alder.md의 작업 예시는 이 광범위한 프로세스가 완성된 프로젝트에 어떻게 적용되었는지 보여줍니다.
기본 사용 예시
광고 제작 계획 생성
Motion Video Kit을 사용해 이 실제 비즈니스를 위한 프리미엄 광고 제작 계획을 작성하세요. 콘셉트, 장면 구조, 모션 메커니즘, 오디오 방향, 렌더링 방식, 측정 가능한 점검 항목, Gauntlet 리뷰 단계를 포함하세요.
기존 렌더 리뷰
Motion Video Kit의 품질 기준과 전체 필름 비평 프로세스를 사용해 이 렌더링된 광고를 리뷰하세요. 측정된 문제와 시각적 또는 비즈니스 관련 우려를 구분한 뒤, 항목별 검증 장부를 작성하세요.
Three.js 장면 평가
키트의 결정론적 렌더링 계약과 사실성 체크리스트를 사용해 이 Three.js 장면을 평가하세요. 장면을 탐색할 수 있는지, 공간 레이어와 콜아웃 및 사진 요소가 시각적으로 설득력을 유지하는지 확인하세요.
고급 팁
Three.js 장면을 결정론적이고 탐색 가능하게 만들기
제작용 렌더링에서는 특정 시점의 상태를 재현할 수 있는 장면을 구축하세요. 결정론적이고 탐색 가능한 동작은 제어되지 않는 실시간 상태에 의존하는 모션보다 프레임 생성, 디버깅, 수정, 리뷰를 더욱 안정적으로 만듭니다.
복잡한 컴포넌트를 독립적으로 개발하기
templates/component-lab.html을 사용해 완성된 필름과 분리된 상태에서 개별 모션 컴포넌트를 작업하세요. 컴포넌트를 격리하면 반복 작업 시간이 줄어들고 통합 전에 타이밍, 가독성, 구성을 더 쉽게 비교할 수 있습니다.
투영 오버레이를 신중하게 사용하기
templates/projected-overlays.js 모듈은 공간 장면과 관련된 오버레이 작업을 지원합니다. 장면 요소와 연결된 상태를 유지해야 하는 투영 콜아웃이나 주석을 만들 때는 문서화된 Three.js 패턴과 함께 사용하세요.
검토 근거를 구체적으로 유지하기
비평자에게 눈에 보이는 프레임, 타이밍 구간 또는 측정 결과를 명시하도록 요청하세요. 그런 다음 새 렌더를 기준으로 각 수정 사항을 검증하세요. 이렇게 하면 수정 장부가 확인되지 않은 변경 사항을 나열하는 목록으로 변질되는 것을 방지할 수 있습니다.
객관적 점검과 주관적 점검을 구분하기
고정된 시간, 음량, 대비, 브랜드 색상 사용은 체계적으로 점검할 수 있습니다. 스타일, 사실성, 설득력, 고객 적합성은 시각적·비즈니스적 판단도 필요합니다. 강력한 검토 프로세스는 한 범주를 다른 범주로 대체하지 않고 두 범주를 모두 활용합니다.
프로젝트의 정직성 규칙을 따르세요
AI로 생성된 이미지를 실제 고객, 완료된 작업 또는 검증된 결과로 제시하지 마세요. 생성된 자료에는 적절한 라벨을 표시하고, 콘셉트 비주얼과 사실에 근거한 비즈니스 증거를 명확히 구분하세요.
상업용 가격 데이터를 다시 확인하세요
저장소의 시장 가격은 2026년 9월 공개 목록을 기준으로 한 시점의 스냅샷입니다. 견적서, 제안서 또는 파일럿 제안을 준비하기 전에 현재 가격을 다시 확인하세요. 스튜디오 포트폴리오에서 인용한 도달 수치는 해당 스튜디오가 주장한 내용이므로 그에 맞게 다뤄야 합니다.
결론
Motion Video Kit은 단순한 비주얼 스타일 가이드 그 이상을 제공합니다. 출시용 광고를 제작할 수 있도록 제작 지침, 재사용 가능한 모션 패턴, 오디오 활용 방식, 비즈니스 포지셔닝, 측정 가능한 점검 항목, 독립적인 비평가 워크플로를 결합합니다. Claude Code 스킬로 설치하거나 다른 LLM에 파일을 제공한 다음, 실제 렌더링 결과를 출시하기 전에 Gauntlet으로 각각 평가하세요.
저장소의 텍스트, 스크립트 및 템플릿은 MIT 라이선스에 따라 제공됩니다. 링크된 레퍼런스 영상에 대한 권리는 각 소유자에게 있습니다.
