TL;DR

이 레포지토리는 Claude Code와 Codex 같은 코드 에이전트와 연동되는 에이전트 스킬로서 Remotion 기반의 실행 가능한 샷 구현과 검증된 프로모 템플릿을 결합해 제품 프로모션 비디오 제작을 자동화한다. 사용자는 106개의 샷 레시피 카드와 161개 모션 프리뷰를 조합해 에이전트에게 지시하면 Remotion TSX 데모와 사운드 비트 싱크가 적용된 완성 영상을 얻을 수 있다. 템플릿과 캡처 스크립트가 포함되어 있어 설치 후 빠르게 프로덕션 수준의 산출물을 재현할 수 있으나 Remotion 빌드 환경과 에이전트 런타임 설정이 선행되어야 한다.

주요 기능

• 스킬은 에이전트에 레포 링크를 전달하면 레포를 클론하고 스킬 디렉터리에 자동으로 연결하여 즉시 사용 가능한 상태로 만든다. 이 과정은 Claude Code 또는 Codex와의 심볼릭 링크 연동을 통해 에이전트 환경에서 바로 호출될 수 있도록 구성되어 있다. 설치 후에는 내장 템플릿과 샷 카드를 에이전트 지시로 곧바로 적용해 비디오 생성 파이프라인을 가동할 수 있다.
• 샷 레시피 카드는 목적, 에너지, 권장 지속시간, 구현 파라미터, 주의점까지 포함하여 반복 가능한 샷 제작 규격을 제공한다. 이 규격은 Remotion TSX 데모와 매핑되어 각 샷의 실제 easing과 타이밍을 재현하게 한다. 결과적으로 제작자가 빠르게 고품질 샷을 조합해 전체 시퀀스를 완성할 수 있다.
• 템플릿은 완성된 36.2초 1920×1080 30fps 프로모 비디오를 포함하여 캡처 스크립트, SFX 라이브러리, 2.5D 카메라 컴포넌트를 제공한다. 에이전트는 제품 스크린샷과 카피를 템플릿에 교체하여 동일한 품질의 영상을 재생산할 수 있다. 템플릿은 검증된 시퀀스와 사운드 디자인을 포함해 빠른 배포 경로를 제공한다.
• 온라인 갤러리는 162개 스타일과 161개 모션 프리뷰를 검색·필터·선택할 수 있는 인터페이스로 샷 선택을 지원한다. 갤러리에서 샷 이름을 복사해 에이전트 명령에 붙여 넣으면 정확한 샷 구현을 재현하도록 유도한다. 이 워크플로는 시각적 선택과 자동화된 구현 사이의 갭을 줄여 프로덕션 시간을 단축한다.

어떻게 동작하는가

레포지토리는 에이전트 스킬 구조를 통해 Claude Code 또는 Codex가 샷 카탈로그와 템플릿을 호출하도록 구성되어 있다. 에이전트가 샷 카드를 선택하면 해당 샷에 대응하는 Remotion TSX 데모와 파라미터가 적용되어 렌더링 파이프라인이 실행된다. 오디오 비트 싱크와 사운드 이펙트는 분석된 타임코드에 맞춰 컷과 트랜지션을 정렬하여 최종 비디오의 박자와 시청각 일치를 확보한다.

해결 문제

제품 또는 데스크톱 애플리케이션을 대상으로 한 고품질 프로모 비디오를 수동으로 기획하고 애니메이션을 조정하는 데 필요한 시간과 전문 스킬 격차를 줄였다. 레포지토리는 샷 단위의 제작 규격과 Remotion 구현을 결합하여 스토리보딩부터 사운드 디자인, 최종 QA까지 반복 가능한 자동화 파이프라인을 제공한다. 따라서 비디오 제작팀이 아닌 개발자나 제품팀도 에이전트 지시만으로 일관된 품질의 프로모 영상을 빠르게 얻을 수 있다.

지금 주목받는 이유

레포지토리는 에이전트 기반 자동화와 코드로 비디오 제작 간의 결합이라는 실용적 조합으로 주목을 받았다. GitHub 상의 스타 수와 온라인 갤러리의 라이브 프리뷰가 활발한 관심을 반영하여 확산에 기여했다. 또한 Claude Code와 Codex 같은 코드 에이전트 생태계가 성장하는 가운데 에이전트 스킬 형태로 배포된 점이 최근 주목 요인이다.

차별점

• 샷 레시피 카드와 실제 Remotion TSX 데모를 1:1로 매핑하여 디자인 규격이 코드 구현으로 직접 이어지도록 통합해두었다. 이로 인해 디자인 의도를 구현 단계에서 재해석하는 비용이 줄어들며 반복 가능한 결과물을 확보할 수 있다. 또한 갤러리에서 스타일과 모션을 시각적으로 선택해 에이전트 명령에 바로 투입할 수 있어 워크플로가 짧다.
• 완성된 프로덕션 템플릿과 비트 싱크, 사운드 이펙트까지 포함한 풀 파이프라인을 제공하여 단순 샘플 코드 수준을 넘는 실무용 산출물을 만들 수 있다. 템플릿은 36.2초 규격과 고정된 카메라 무브, 트랜지션, SFX 패스가 포함되어 템플릿 교체만으로 일관된 영상 품질을 재현한다. 이 점이 단순한 모션 프리셋 모음과 구별되는 핵심이다.
• 에이전트 스킬 형태로 배포되어 Claude Code 및 Codex 같은 코드 기반 에이전트와 즉시 연동되도록 설계되었다. 에이전트가 설치 명령을 수행하면 레포를 스킬 디렉터리에 연결해 비디오 제작 명령을 자동으로 실행할 수 있다. 이 접근법이 수동 설정을 필요로 하는 다른 Remotion 예제들과의 차별화 요소이다.

사용 사례

• 제품 출시용 짧은 데모 또는 프로모션 영상을 빠르게 제작하는 상황에서 제품 스크린샷과 카피를 템플릿에 교체해 즉시 완성 영상을 얻을 수 있다. 에이전트가 샷 카드를 조합하고 Remotion 데모를 호출하므로 비디오 제작 경험이 적은 팀도 일정한 품질을 확보할 수 있다. 반복 릴리즈마다 동일한 템플릿을 재사용해 캠페인 일관성을 유지할 수 있다.
• 기능 데모 또는 신규 기능 발표에서 특정 흐름을 강조할 때 샷 카드를 조합해 시퀀스를 구성하고 박자에 맞춘 컷 편집으로 주목도를 높일 수 있다. 비트 싱크와 사운드 디자인 파이프라인을 함께 적용하면 시청각 결합이 강화되어 메시지 전달력이 증가한다. 개발자 주도의 자동화로 반복적인 데모 제작 비용과 시간을 절감할 수 있다.
• 브랜드 필름이나 소셜용 짧은 클립을 제작할 때 시각적 규격과 사운드 패스를 템플릿에 적용해 빠르게 변형된 버전을 대량으로 생성할 수 있다. 갤러리에서 스타일을 필터링해 다양한 브랜드 톤에 맞는 샷을 선택하고 에이전트로 배치하여 여러 버전의 영상을 자동으로 생성할 수 있다. 이 워크플로는 캠페인 테스트와 A/B용 변형 제작에 적합하다.

시작하기

가장 간단한 방법은 Claude Code 또는 Codex에 레포 링크를 전달해 스킬을 설치하도록 지시하는 것이다. 수동 설치는 npx skills add Vincentwei1021/video-shotcraft 또는 git clone 후 ~/.claude/skills 또는 ~/.codex/skills에 심볼릭 링크를 생성하면 된다. 설치 후에는 에이전트에 템플릿 사용과 샷 카드 지정을 요청하면 Remotion 기반 렌더링 파이프라인이 가동된다.

요구사항

• Node.js와 Remotion 환경이 설치되어야 하며 Remotion 빌드와 렌더링이 로컬 또는 CI에서 실행 가능해야 한다.
• Claude Code 또는 Codex처럼 에이전트 스킬을 로드할 수 있는 에이전트 런타임이 필요하며 해당 런타임의 스킬 디렉터리에 심볼릭 링크를 만들 수 있어야 한다.
• 템플릿에서 사용하는 오디오와 이미지 자산은 라이선스 조건을 확인하여 교체할 때 적절한 권한을 확보해야 한다.