video-shotcraft
무엇인가
video-shotcraft는 제품 소개·마케팅·런칭·데모 영상을 만드는 작업을 규율하는 에이전트 스킬이다. 대상은 영상 제작 파이프라인 전체로, 스토리보드 구성, 샷 레시피 선택, 2.5D 카메라 무브, 비트 동기 컷 편집, SFX 설계, 렌더까지의 절차를 규칙과 자산으로 고정한다. 에이전트가 영상 요청을 받았을 때 매번 즉흥적으로 컷과 모션을 짜는 대신, 저장소에 정의된 레시피와 템플릿을 참조해 동일한 형식으로 결과물을 산출하도록 만든다.
어떻게 동작하나
구조는 SKILL.md를 진입점으로 하는 스킬 팩이다. 샷 레시피 카드는 마크다운 카드로 존재하고, 각 카드에는 정규화된 진행값 t로 구동되는 결정적 Remotion 컴포넌트(demos/*.tsx)가 대응한다. 카드와 컴포넌트의 연결 방식은 demos/README.md에 명시되어 있다. 별도로 검증된 완성 템플릿인 Ink Press(1920×1080, 30fps, 종이·잉크·앰버 스타일의 다중 샷 구성)가 포함되어 있어, 제품 스크린샷·카피·브랜딩만 교체해 같은 품질을 재현할 수 있다. 납품 후에는 workbench 스크립트로 브라우저 기반 편집기를 열어 샷·전환·캡션·SFX 트랙을 스키마 기반 인스펙터에서 수정하고 다시 Remotion으로 내보낸다. JianYing(캡컷 중국판) 드래프트로의 내보내기 절차는 references/jianying-export.md에 정의되어 있다.
무엇과 다른가
프롬프트를 직접 작성하거나 단일 CLAUDE.md에 문장 규칙만 넣는 방식과 다르다. 규칙이 산문 지시가 아니라 실행 가능한 자산(레시피 카드, Remotion 컴포넌트, 템플릿, 모션 프리뷰, 편집 워크벤치, 내보내기 스크립트)에 묶여 있고, 에이전트는 카드 이름을 지정받아 해당 컴포넌트를 그대로 호출한다. 결과적으로 모션의 타이밍과 곡선이 매 실행마다 달라지지 않고, 프리뷰와 최종 렌더가 프레임 단위로 일치하도록 검증된 경로를 따른다. 모든 카드는 중립 플레이스홀더 카피와 단일 ACCENT 색상 변수로 디브랜딩되어 있어 제품별로 교체만 하면 된다.
어떻게 쓰나
설치는 저장소 링크를 에이전트에 넘기는 방식이 가장 직접적이다. `npx skills add Vincentwei1021/video-shotcraft`로 설치하거나, 저장소를 클론한 뒤 `ln -s "$(pwd)" ~/.claude/skills/video-shotcraft`(Codex는 ~/.codex/skills/)로 스킬 디렉터리에 링크한다. 첫 사용은 "Use video-shotcraft to create a promo for my desktop product"처럼 요청하고, 특정 카드를 쓰려면 deck-deal-flyin, row-embed, spotlight-hero-card 같은 카드 이름을 함께 지정한다. 카드를 지정하지 않으면 내장 템플릿을 먼저 소개하고 사용 여부를 묻는다. 템플릿을 쓰려면 "Use video-shotcraft to make a promo for my product with the Ink Press template"이라고 지시한다.
전제와 한계
Claude Code와 Codex를 대상으로 하며 Node.js 실행 환경과 Remotion 렌더용 Chrome 헤드리스 셸 바이너리가 필요하다. 헤드리스 리눅스에서는 코어 수가 적을 때 `--concurrency=1`을 넘겨야 하고, 최신 Chrome/Chromium에서 제거된 구형 헤드리스 모드 대신 chrome-headless-shell을 지정해야 하며, remotion.media 접근이 차단된 환경에서는 `--browser-executable=`로 경로를 직접 지정해야 한다. 주 대상은 웹·데스크톱 제품 홍보 영상이고, 개별 샷 카드는 기능 데모에 부분적으로 재사용할 수 있다. JianYing 내보내기는 macOS의 JianYing Pro 11.2에서 검증된 범위까지 지원한다.