video-shotcraft는 Claude Code나 Codex가 웹·데스크톱 제품의 홍보 영상을 Remotion 코드로 만들도록 돕는 Agent Skill이다. 설치는 저장소 주소를 에이전트에 건네는 방식으로 간단하지만, 영상 제작 과정에서 프로젝트 파일·브라우저·셸을 폭넓게 사용한다. 따라서 장난감 프롬프트 모음보다는 권한을 검토한 뒤 격리된 프로젝트에서 사용하는 제작 도구로 보는 편이 정확하다.
출처: 직접 제작
핵심 요약
- 2026년 7월 19일 공개된 뒤 약 45일 만에 GitHub 별 7,015개를 모은 급상승 Agent Skill이다.
- 157개 샷 레시피와 214개 모션 미리보기, Remotion 템플릿을 제공한다.
- Claude Code와 Codex 설치를 격리된 임시 환경에서 직접 확인했고 제거까지 정상 동작했다.
- 설치 스캐너 결과는 Gen Safe, Socket 0 alerts였지만 Snyk는 High Risk로 표시했다. 여러 스캐너 판단이 엇갈리므로 무조건 안전하다고 단정하면 안 된다.
- 제품 화면을 캡처하므로 고객 정보, API 키, 내부 데이터가 노출되지 않도록 별도 검토가 필요하다.
- Higgsfield처럼 영상을 직접 생성하는 서비스와 달리 실제 제품 화면을 Remotion 코드로 조립한다. 두 도구는 대체재라기보다 서로 다른 장면에 맞는 보완재에 가깝다.
video-shotcraft가 해결하는 문제
제품 소개 영상을 직접 만들려면 화면 캡처, 장면 구성, 애니메이션, 전환, 배경음악과 효과음, 렌더링을 각각 처리해야 한다. 개발자가 Remotion으로 영상을 만들 수는 있지만, 어떤 카메라 움직임과 전환을 써야 하는지부터 다시 설계하면 시간이 오래 걸린다.
video-shotcraft는 이 과정을 에이전트가 따라갈 수 있는 제작 절차로 정리한 Skill이다. 저장소에는 다음 자산이 포함돼 있다.
| 구성 | 저장소가 안내하는 내용 |
|---|---|
| 샷 레시피 | 157개 |
| 모션 미리보기 | 214개 |
| 영상 엔진 | React 기반 Remotion |
| 완성 템플릿 | 36.2초, 1920×1080, 30fps Ink Press 템플릿 |
| 사운드 | 16개 범주, 149개 효과음과 BGM 후보 |
| 지원 에이전트 | Claude Code, Codex 등 Agent Skills 호환 도구 |
| 라이선스 | 저장소는 Apache-2.0, Remotion과 개별 음원은 별도 조건 확인 필요 |
단순히 “멋진 영상을 만들어줘”라는 프롬프트를 추가하는 구조는 아니다. 에이전트가 제품을 확인하고, 실제 화면을 캡처하고, 샷 카드를 고르고, Remotion 프로젝트를 수정하고, 렌더링 결과를 다시 검사하는 작업 흐름을 제공한다.
왜 지금 살펴볼 만한가
GitHub API에서 확인한 2026년 9월 2일 기준 수치는 다음과 같다.
- 저장소 생성: 2026년 7월 19일
- GitHub stars: 7,015
- forks: 623
- 확인한 커밋:
6c116cbd24eeb43c99d396696b509f8d88e58789 - 저장소 생성 후 경과: 약 44.5일
- 생성 이후 단순 평균 증가량: 약 158 stars/일
이 값은 매일의 실제 별 증가량이 아니라 현재 별 수를 저장소 나이로 나눈 단순 평균이다. 그래도 한 달 남짓한 기간에 7천 개 이상을 모았다는 점은 초기 관심이 빠르게 커졌다는 신호로 볼 수 있다.
관심도만으로 추천한 것은 아니다. 이번 글에서는 실제 저장소를 내려받고 Agent Skills CLI로 Claude Code와 Codex 대상 설치를 실행했다. 설치 후 파일 위치와 목록을 확인하고 제거 명령으로 원상복구되는 것까지 검증했다.
어떤 상황에서 유용한가
다음과 같은 작업에 잘 맞는다.
- SaaS나 웹 서비스의 출시·업데이트 소개 영상
- 데스크톱 앱의 주요 기능 홍보 영상
- 랜딩 페이지에 넣을 짧은 제품 영상
- 화면 녹화만으로는 밋밋한 기능 데모
- Remotion을 사용하지만 장면 구성과 움직임 설계가 어려운 경우
- 디자인 전문 인력 없이 개발자가 초안을 빠르게 만들려는 경우
반대로 인터뷰, 실사 촬영, 캐릭터 애니메이션, 장편 영상 편집이 중심이라면 이 Skill의 주력 범위와 다르다. 저장소도 웹·데스크톱 제품 홍보 영상에 초점을 맞추고 있다.
Higgsfield와 비교하면 무엇이 다른가
Higgsfield도 제품·광고 영상을 만들 수 있어 결과만 보면 video-shotcraft와 비슷해 보인다. 그러나 제작 방식은 다르다. Higgsfield는 여러 이미지·영상 생성 모델을 한곳에서 사용하는 클라우드 플랫폼이고, video-shotcraft는 Claude Code나 Codex가 실제 제품 화면과 Remotion 코드를 다루도록 만드는 로컬 Agent Skill이다.
Higgsfield 공식 MCP 페이지는 Soul, Cinema Studio, Flux, Seedream, Kling, Minimax Hailuo, Veo 등을 포함한 30개 이상의 모델을 제공한다고 안내한다. 텍스트나 참조 이미지에서 최대 15초 영상을 생성하며, 에이전트는 Higgsfield 계정 인증 후 기존 구독 크레딧을 사용한다.
| 비교 기준 | video-shotcraft | Higgsfield |
|---|---|---|
| 제품 분류 | 로컬 Agent Skill과 Remotion 제작 자산 | 클라우드 생성형 미디어 플랫폼·모델 집계 계층 |
| 주요 입력 | 실제 웹·앱 화면, 프로젝트 파일, 브랜드 토큰 | 텍스트 프롬프트, 이미지, 이전 생성 결과 |
| 결과 생성 방식 | React·Remotion 코드로 장면을 조립하고 렌더링 | 선택한 생성 모델이 이미지·영상을 생성 |
| 제품 UI 정확도 | 실제 스크린숏을 사용하므로 높이기 쉽다 | 생성 과정에서 UI·문자·수치가 달라질 수 있다 |
| 인물·실사 장면 | 주력 범위가 아니다 | UGC, 패션, 인물, 광고 장면에 적합하다 |
| 수정 방식 | 코드·타이밍·문구·색상을 지정해 다시 렌더링 | 프롬프트·참조 이미지를 바꿔 다시 생성 |
| 재현성 | 코드와 고정 자산을 유지하면 비교적 높다 | 같은 프롬프트도 결과가 달라질 수 있다 |
| 길이 | 장면을 이어 구성하며 36.2초 템플릿도 제공 | 공식 MCP 안내 기준 개별 영상 최대 15초 |
| 비용 구조 | Skill은 오픈소스지만 에이전트·모델·렌더링·Remotion 조건이 별도다 | 모델과 해상도에 따라 구독 크레딧을 소비한다 |
| 데이터 처리 | 로컬 작업이 가능하지만 사용하는 에이전트·모델의 전송 범위는 별도 확인이 필요하다 | 프롬프트와 입력 자산을 클라우드 서비스에 전달한다 |
| 에이전트 연결 | 로컬 Skill 파일을 Claude Code·Codex에 설치 | 공식 MCP 연결 후 Higgsfield 계정으로 인증 |
실제 제품 화면이 중요하면 video-shotcraft
SaaS 기능 소개 영상에는 버튼 이름, 요금 숫자, 차트, 화면 배치가 정확해야 한다. 생성형 영상 모델은 분위기 있는 장면을 빠르게 만들 수 있지만 작은 UI 문자와 실제 화면 구조를 그대로 유지하는 데 불리하다. video-shotcraft는 실제 화면을 캡처한 뒤 카메라 이동과 전환을 코드로 더하므로 제품 정확도를 유지하기 쉽다.
수정 방식도 다르다. “가격 문구만 바꾸고 두 번째 장면을 12프레임 늦춰 달라”와 같은 요청은 코드 기반 영상이 유리하다. 장면과 타이밍이 소스에 남아 있어 해당 부분만 고쳐 다시 렌더링할 수 있기 때문이다.
인물과 실사 광고 컷이 필요하면 Higgsfield
사용자가 제품을 들고 말하는 UGC 광고, 패션 촬영, 영화 같은 배경과 카메라 움직임, 실제로 촬영하기 어려운 장면은 Higgsfield 쪽이 맞다. 공식 MCP는 30개 이상의 모델을 제공하고, 에이전트가 작업에 맞는 모델을 고르거나 사용자가 직접 지정할 수 있다고 안내한다.
대신 생성 결과를 여러 번 비교하는 과정이 필요할 수 있다. 모델·해상도마다 크레딧이 다르고 재시도도 비용에 포함되므로, 월간 크레딧을 곧바로 “영상 몇 개”로 환산하면 안 된다.
구독 가격과 오픈소스만 비교하면 안 된다
2026년 9월 2일 한국 지역 응답으로 확인한 Higgsfield 가격 API에는 Starter 월 15달러·200크레딧, Plus 월 49달러·1,000크레딧이 표시됐다. 연간 결제와 상위 요금제는 별도 금액과 할인이 적용될 수 있으며, 계정별 실험군이 바뀔 수 있으므로 실제 체크아웃 가격이 최종 기준이다.
video-shotcraft 저장소는 Apache-2.0이지만 비용이 0이라는 뜻은 아니다. Claude Code·Codex 사용 비용, 선택한 모델 비용, 렌더링 장비와 시간, 회사 사용 시 Remotion 라이선스가 별도로 발생할 수 있다. Higgsfield는 크레딧 비용이 명확한 대신 로컬 렌더링 환경을 직접 구축할 필요가 적다.
둘을 함께 쓰는 방법도 있다
두 도구는 직접 대체재보다 보완재에 가깝다. 제품 영상이라면 다음 구성이 현실적이다.
- Higgsfield로 시선을 끄는 오프닝, 인물 UGC, 배경 B-roll을 만든다.
- video-shotcraft로 실제 제품 UI, 기능 설명, 차트와 자막 장면을 만든다.
- Remotion 타임라인에서 생성 영상과 실제 제품 장면을 합치고 사운드·자막을 맞춘다.
브랜드 분위기와 실사 장면은 생성형 모델에 맡기고, 틀리면 안 되는 제품 정보는 실제 화면과 코드로 유지하는 방식이다. 정확도와 시각적 임팩트를 동시에 확보하려면 이 혼합 방식이 가장 실용적이다.
Claude Code와 Codex에 설치하는 방법
Node.js와 npm을 사용할 수 있는 환경이라면 Agent Skills CLI로 설치할 수 있다.
npx skills add Vincentwei1021/video-shotcraft \
-g \
-a claude-code codex \
-s video-shotcraft \
-y격리된 임시 HOME에서 이 명령을 실행한 결과 설치 종료 코드는 0이었다. 공용 Skill은 다음 위치에 생성됐다.
~/.agents/skills/video-shotcraftClaude Code용 경로에는 공용 Skill을 가리키는 심볼릭 링크가 만들어졌다.
~/.claude/skills/video-shotcraftCodex는 공용 Agent Skills 경로를 사용하는 방식으로 설치 요약에 표시됐다. 설치 결과는 다음 명령으로 확인할 수 있다.
npx skills list -g --json포스팅 주소를 에이전트에 붙여 넣어 설치시키는 프롬프트
다음 프롬프트와 이 글의 주소를 Claude Code나 Codex에 함께 전달하면 된다.
이 글의 설치 절차와 공식 GitHub 저장소를 읽어줘.
현재 환경이 Claude Code인지 Codex인지 확인하고,
설치 전에 변경될 경로와 필요한 권한을 먼저 설명해줘.
skills.sh 보안 평가에서 Snyk High Risk 경고가 있었으므로
SKILL.md와 실행 스크립트를 검토하고, 위험한 동작이나
외부 전송 가능성이 있으면 설치를 중단하고 알려줘.
문제가 없으면 video-shotcraft를 설치하고
npx skills list -g --json으로 설치 결과를 확인해줘.
검증한 기준 커밋은 6c116cbd24eeb43c99d396696b509f8d88e58789이며,
현재 HEAD가 다르면 주요 변경 사항을 먼저 요약해줘.
글 주소:
여기에 이 포스팅 주소를 붙여 넣기저장소 README의 가장 짧은 방식은 Install this skill for me: 뒤에 GitHub 주소를 붙이는 것이다. 그러나 에이전트가 저장소의 현재 main 브랜치를 가져올 수 있으므로 위처럼 변경 경로와 최신 차이를 먼저 확인하도록 요청하는 편이 안전하다.
설치 전 반드시 확인할 보안 경고
Agent Skills CLI가 설치 전에 표시한 보안 결과는 다음과 같았다.
| 검사기 | 결과 |
|---|---|
| Gen | Safe |
| Socket | 0 alerts, Low Risk, score 87 |
| Snyk | High Risk |
세 검사 결과가 일치하지 않는다. 해당 감사 API는 Snyk가 High Risk로 분류했다는 결과와 분석 시각만 제공하고 상세 근거는 반환하지 않았다. 따라서 “다른 검사기가 안전하다고 했으니 문제없다”거나 “High Risk이므로 악성 코드다”라고 어느 한쪽으로 단정하기 어렵다.
저장소를 직접 확인했을 때 루트 package.json에는 테스트 명령만 있었고 preinstall이나 postinstall 스크립트는 없었다. 템플릿의 package.json도 Remotion 실행 명령과 고정된 주요 패키지 버전으로 구성돼 있었다. 검색한 범위에서 자동 설치 단계에 원격 스크립트를 내려받아 실행하는 패턴은 확인되지 않았다.
다만 Skill의 본래 작업 범위가 넓다. 제품 프로젝트를 읽고, 로컬 개발 서버를 실행하고, 브라우저로 화면을 캡처하고, 파일을 복사·수정하고, npm 패키지를 설치하고, 최종 영상을 렌더링한다. Agent Skill은 에이전트 권한으로 실행되므로 설치 파일 자체가 단순해도 실제 사용 단계의 권한은 크다.
안전하게 사용하려면 다음 기준을 지키는 편이 좋다.
- 처음에는 운영 프로젝트가 아닌 복제본이나 별도 worktree에서 실행한다.
.env, 고객 정보, 관리자 화면, 내부 URL을 캡처 대상에서 제외한다.- 에이전트가 실행하려는 설치·셸 명령을 먼저 보여 달라고 요청한다.
- 현재 저장소 HEAD가 이 글에서 검증한 커밋과 다르면 변경 내용을 확인한다.
- 회사에서 사용한다면 Remotion의 별도 라이선스를 확인한다.
- 완성 영상에 포함된 음원·이미지·제품 데이터의 사용 조건을 최종 검토한다.
실제 사용 방법
설치한 뒤에는 제품 경로나 주소와 원하는 제작 방식을 함께 알려주는 편이 좋다.
video-shotcraft를 사용해 이 프로젝트의 30초 제품 소개 영상을 만들어줘.
프로젝트 경로는 /path/to/project야.
먼저 읽기 전용으로 제품과 화면 상태를 확인하고,
민감한 데이터가 캡처될 가능성을 정리해줘.
그다음 사용할 제작 모드와 샷 구성을 추천해줘.Skill은 완성 영상 제작 방식을 세 가지로 구분한다.
- Ink Press 템플릿 사용: 기존 36.2초 템플릿의 장면 구조를 유지하고 제품 화면과 문구를 교체한다.
- 자율 제작: 에이전트가 제품 분석부터 장면·사운드·렌더링까지 연속해서 진행한다.
- 공동 제작: 제품 요약, 시각 방향, 샷 구성과 스토리보드를 단계별로 확인하며 진행한다.
처음 사용한다면 공동 제작이 안전하다. 자율 제작은 빠르지만 제품 화면과 데이터 처리, 설치되는 패키지, 결과물 방향을 중간에 놓치기 쉽다.
실행 비용과 현실적인 제약
Skill 설치만으로 영상이 즉시 생성되는 것은 아니다. 실제 렌더링에는 Remotion 프로젝트 의존성과 Chromium 계열 브라우저, 저장 공간, CPU 시간이 필요하다. 저장소를 얕게 복제한 상태만 약 97MB였고, node_modules와 렌더링 결과는 여기에 포함되지 않았다.
저장소는 저사양 헤드리스 Linux에서 다음 문제를 별도로 안내한다.
- CPU 코어가 적으면 Remotion 동시성을 1로 낮춰야 할 수 있다.
- 최신 Chromium에서는 기존 headless 모드가 제거돼
chrome-headless-shell이 필요할 수 있다. - Remotion 다운로드 도메인이 차단되면 로컬 브라우저 실행 파일을 직접 지정해야 한다.
즉, Skill 설치와 영상 제작 환경 구축은 다른 단계다. 설치 성공만 확인하고 “바로 영상 생성이 끝난다”고 기대하면 안 된다.
삭제하는 방법
이번 검증에서는 다음 명령으로 공용 Skill과 Claude Code 심볼릭 링크가 모두 제거되는 것을 확인했다.
npx skills remove video-shotcraft -g -y제거 후 다음 두 경로가 남아 있지 않은지 확인하면 된다.
ls ~/.agents/skills/video-shotcraft
ls ~/.claude/skills/video-shotcraftSkill을 이용해 별도의 Remotion 프로젝트를 만들었다면 그 프로젝트와 설치된 node_modules, 렌더링 결과물은 별도로 정리해야 한다. Skill 제거 명령이 사용자가 생성한 영상 프로젝트까지 지워주는 것은 아니다.
결론: 누구에게 추천할 수 있나
video-shotcraft는 AI가 영상을 직접 생성하는 모델이라기보다, 코딩 에이전트가 Remotion 기반 제품 영상을 만들도록 제작 지식과 자산을 제공하는 Skill이다. 제품 화면을 실제로 활용하고 코드로 수정 가능한 영상을 만들고 싶다면 살펴볼 가치가 있다.
다만 설치가 쉽다는 이유만으로 운영 저장소에서 바로 실행할 도구는 아니다. 보안 스캐너 판단이 엇갈리고, 실제 제작 과정에서 파일·브라우저·셸 권한을 폭넓게 사용한다. 별도 작업 복사본에서 시작하고 변경 명령과 캡처 데이터를 확인하는 조건이라면 개발자가 제품 영상 초안을 빠르게 만드는 데 유용한 도구에 가깝다.
FAQ
Claude Code와 Codex에서 모두 사용할 수 있나?
Agent Skills CLI로 두 대상을 지정해 설치할 수 있다. 이번 검증에서는 공용 Skill 경로와 Claude Code용 심볼릭 링크가 생성됐고 설치 목록에서도 정상 확인됐다.
API 키가 반드시 필요한가?
Skill 자체 설치에는 별도의 API 키가 필요하지 않았다. 다만 사용 중인 Claude Code나 Codex의 이용 환경은 별도로 필요하며, 영상 제작 과정에서 추가 서비스나 패키지를 선택하면 해당 조건이 생길 수 있다.
영상 제작에 Remotion 유료 라이선스가 필요한가?
Remotion은 별도 라이선스 정책을 사용한다. 저장소 안내에 따르면 개인과 소규모 팀은 무료 범위가 있지만 회사 사용자는 유료 조건이 적용될 수 있다. 실제 사용 시 Remotion 공식 라이선스 문서를 확인해야 한다.
Snyk High Risk이면 설치하면 안 되는가?
이 결과만으로 악성 Skill이라고 단정할 수는 없다. 다른 검사기는 Safe 또는 0 alerts를 표시했다. 반대로 다른 결과가 좋다는 이유로 안전을 보장할 수도 없다. 권한 범위와 현재 소스를 검토하고 격리된 프로젝트에서 실행하는 것이 핵심이다.
Higgsfield 대신 video-shotcraft를 쓰면 되는가?
완전한 대체 관계는 아니다. 실제 제품 UI와 수정 가능한 모션 그래픽이 중요하면 video-shotcraft가 맞고, 인물·실사풍 광고와 생성형 B-roll이 필요하면 Higgsfield가 맞다. 두 종류의 장면이 모두 필요하면 함께 사용하는 편이 좋다.
설치 후 업데이트는 어떻게 하나?
Agent Skills CLI의 npx skills update 계열 명령을 사용할 수 있다. 다만 업데이트하면 이 글에서 확인한 커밋과 달라질 수 있으므로 변경 내역을 먼저 검토하는 편이 좋다.
함께 읽으면 좋은 글
- AI 에이전트 추적 실무: OpenTelemetry로 지연·토큰·도구 호출 연결하기
- AI 에이전트 관측 도구 비교: Langfuse vs LangSmith vs Phoenix vs OpenTelemetry
참고 자료
- video-shotcraft 공식 GitHub 저장소
- video-shotcraft 모션 Gallery
- skills.sh의 video-shotcraft 페이지
- Agent Skills 공식 문서
- Remotion 공식 라이선스
- Higgsfield 공식 MCP 안내
- Higgsfield 공식 요금제
- Higgsfield API 문서
*검증 기준일: 2026년 9월 2일. GitHub 별 수, 저장소 내용과 보안 감사 결과는 이후 변경될 수 있다.*
