video-spec-builder
무엇인가
video-spec-builder는 영상 제작 요청을 받은 에이전트가 곧바로 결과물을 만들러 가지 않고, 기획을 샷 단위 명세로 확정할 때까지 질문을 이어 가도록 강제하는 스킬이다. 규율하는 영역은 렌더링이 아니라 그 앞단, 즉 "무엇을 만들 것인가"가 문장으로 고정되기 전의 단계다. 대상 시청자, 게재 위치, 총 길이, 핵심 메시지, 샷 순서처럼 제작 전에 반드시 정해져야 하는 항목을 에이전트가 대신 캐내고, 사용자가 비워 둔 칸을 그대로 넘기지 못하게 한다.
어떻게 동작하나
설치되면 skills CLI가 배포하는 스킬 묶음의 규칙 파일(SKILL.md 계열)로 프로젝트나 전역 스코프에 배치된다. 발동은 두 갈래다. Codex·Claude Code에서 "영상을 만들고 싶다"는 자연어 발화에 자동으로 걸리거나, Claude Code에서 `/video-spec-builder` 슬래시 명령으로 직접 호출한다. 발동 후에는 정해진 순서로 대화를 진행한다. 기본 조건(대상·게재처·길이·핵심 메시지)을 먼저 확정하고, 보유 소재를 파악한 뒤, 스타일과 페이스, 비주얼 테마를 정하고, 마지막으로 레퍼런스 영상과 반례를 통해 기준을 보정한다. "프리미엄", "임팩트 있는" 같은 추상어는 거부하고 실제 화면과 움직임으로 서술될 때까지 되묻는다. 산출물은 `video-spec.md` 한 파일로, 샷마다 화면 내용·연출 방식·유지 시간·다음 샷으로의 전환이 초 단위로 기록된다.
무엇과 다른가
프롬프트를 직접 쓰거나 일반적인 CLAUDE.md 규칙을 두는 방식과 구조적으로 다르다. 첫째, 산출물이 사람이 읽는 기획서가 아니라 하위 렌더러가 그대로 소비하는 명세 파일이다. 둘째, 심문 절차 자체가 규칙으로 들어 있어 에이전트가 임의로 질문을 줄이거나 요약하고 넘어갈 수 없다. 셋째, HyperFrames와 상하류로 짝을 이룬다. 이 스킬이 아이디어를 스크립트로 바꾸고, HyperFrames가 그 스크립트를 영상으로 렌더링하는 2단 구조이므로, 두 스킬을 함께 설치해야 파이프라인이 완성된다.
어떻게 쓰나
설치는 `npx skills add feicaiclub/video-spec-builder` 한 줄이다. 기본값은 현재 폴더 기준 프로젝트 스코프라 그 프로젝트에서만 동작하고, 자주 쓸 경우 `-g`를 붙여 전역으로 설치한다. Node 18 이상이 필요하며 npx가 실행용 복사본만 받아 쓰므로 별도 사전 설정은 없다. 첫 사용은 Codex나 Claude Code에서 "3분짜리 제품 데모를 만들어서 YouTube에 올릴 거야"처럼 평문으로 말하면 된다. 프로젝트에 이미 `video-spec.md`가 있으면 "3번 샷이 너무 빠르니 늦춰줘" 식으로 변경만 요청할 수 있고, 이때 다른 샷에 영향이 가는지 확인하는 절차가 함께 돈다. 확정된 스크립트는 `/hyperframes`로 넘겨 렌더링한다.
전제와 한계
Codex와 Claude Code에서 가장 잘 동작하며, skills CLI를 통해 Cursor 등 다른 에이전트에도 같은 명령으로 설치된다. 렌더링까지 하려면 HyperFrames 스킬을 별도로 선행 설치해야 한다. 이 스킬은 영상을 촬영하거나 생성하지 않고, 아이디어를 대신 발명하지도 않는다. 사용자가 말한 내용을 정확한 스크립트로 바꾸는 일만 한다. 또한 하류 렌더러인 HyperFrames가 HTML 기반이므로, HTML과 CSS로 그릴 수 없는 장면은 스크립트에 담아도 영상으로 나오지 않는다.