본문으로 건너뛰기
에이전트 Skills 전체 목록

video-shotcraft

  • 추천0
  • GitHub 별22K
  • 영상라이선스Apache-2.0

Claude Code·Codex용 영상 스킬. Remotion으로 제품 홍보 영상을 만들고, 샷 레시피 124장·비트 싱크·사운드 디자인을 지원해요

원본:Vincentwei1021/video-shotcraft

요약

Claude Code·Codex용 영상 스킬. Remotion으로 제품 홍보 영상을 만들고, 샷 레시피 124장·비트 싱크·사운드 디자인을 지원해요

설명

video-shotcraft

갤러리 쇼케이스

GitHub 별 라이선스 Claude Code Codex

▶ 갤러리에서 150개 샷 모두 보기 · 🎬 쇼케이스 보기

무엇을 하나요

Claude Code나 Codex에 "내 제품 홍보 영상을 만들어 줘"라고 말하면 됩니다. 에이전트는 실제 제품 화면을 캡처하고, 잘 다듬어 둔 모션 레시피 라이브러리에서 샷을 고르고, 스토리보드를 짠 뒤, Remotion으로 애니메이션을 만들고, 음악 박자에 맞춰 컷을 자르고, 사운드 디자인을 더하고, 모든 프레임을 검수해서 계속 고칠 수 있는 완성 MP4를 건네줍니다.

영상 생성 AI가 아닙니다. 모든 프레임을 여러분의 스크린샷과 문구로 코드가 직접 그려요. 그래서 결과물이 선명하고, 브랜드 느낌이 살아 있고, 전부 편집할 수 있습니다.

작동 방식

8초 워크플로 루프: 제품 → 실제 화면 캡처 → 샷 레시피 카드로 스토리보드 → Remotion 애니메이션 → 비트 싱크와 사운드 디자인 → 렌더링과 프레임 검수 → MP4, Motion Workbench, JianYing 초안

새 소식

🎬 2026-10 · 샷 라이브러리 새 단장 데모 216개를 모두 다듬고 검토했어요. 가장 좋은 버전만 모아 이제 카드 124장 / 샷 150개로 구성했고, 갤러리 미리보기와 video-shotcraft 브랜딩도 새로 바꿨습니다.

  • 2026-09 · Motion Workbench. 완성한 영상을 CapCut 스타일 브라우저 편집기에서 계속 고칠 수 있어요.
  • 2026-08 · video-talkcraft. 내레이션 영상용 자매 프로젝트예요. 대본과 목소리를 넣으면 모든 모션 비트가 음성에 맞춰 고정됩니다(내레이션 미리보기 78개).
  • 2026-08 · JianYing(중국판 CapCut) 내보내기. 완성한 영상을 샷별 클립, 기본 자막 트랙, 효과음·배경음악 트랙이 나뉜 편집용 JianYing 초안으로 바꿔 줘요. macOS용 JianYing Pro 11.2에서 확인했어요(가이드).

설치

Claude Code와 Codex에 맞춰 만들고 다듬었어요. 가장 쉬운 방법은 에이전트에게 링크를 건네는 것입니다.

Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft

skills CLI로도 설치할 수 있어요.

npx skills add Vincentwei1021/video-shotcraft

직접 설치하려면 이렇게 합니다.

git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft   # Claude Code
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft    # Codex

중국 본토에서 GitHub이 느리면 AtomGit 미러에서 받으세요: git clone https://atomgit.com/VincentWei/video-shotcraft.git.

사용법

만들고 싶은 영상을 그냥 설명하면 됩니다. 별도 명령어는 필요 없어요.

이렇게 말하면이렇게 동작해요
Use video-shotcraft to make a promo for my product.에이전트가 Ink Press 템플릿을 소개하고 쓸지 물은 뒤, 페이지를 캡처해서 영상을 만들어요
Make a launch film for this repo with the Ink Press template.가장 빠른 길이에요. 여러분의 스크린샷·문구·로고를 검증된 템플릿에 넣어요
Use the deck-deal-flyin and row-embed shot cards to present this feature.샷 이름을 직접 골라요(갤러리에서 이름을 그대로 복사하세요)
Design a product close-up inspired by spotlight-hero-card.샷 하나를 여러분의 제품에 맞게 바꿔요

샷 라이브러리

10개 분류에 레시피 카드 124장, 샷은 모두 150개예요. 갤러리에서 검색하고, 거르고, 카드 이름을 복사할 수 있어요.

분류샷 수예시
오프닝·브랜드11text-as-mask: 제목 글자 사이로 제품이 비쳐 보여요
카메라13exploded-view: 페이지가 기울어지며 조각조각 분리돼요
트랜지션19card-flock-tumble: 카드 무리가 헤드라인으로 바뀌어요
타이포그래피25flying-words: 단어 터널이 슬로건으로 모여요
UI 등장22card-stack: 부채꼴 카드가 제자리에 깔려요
인터랙션13palette-theme-ripple: 새 테마가 UI 전체로 물결처럼 퍼져요
데이터9axis-rescale-shock: 급등한 값이 축을 깨고 올라가요
빛·강조23spotlight-sweep: 무대 조명이 제목을 찾아내요
리듬8paparazzi-flash: 플래시 세 번, 크롭 세 번, 숫자 하나
아웃트로7input-morph-assemble: 채팅창이 로고로 조립돼요

카드는 references/shots/<분류>/<카드>.md에 있고, Remotion 구현은 demos/<분류>/<카드>/에 있어요(프로젝트에 연결하는 방법은 demos/README.md를 보세요).

Motion Workbench

영상을 건네고 나면 스킬이 브라우저에서 CapCut 스타일 편집기를 열어 줘요(node workbench/scripts/open.mjs <프로젝트>). 영상은 만든 그대로 샷·트랜지션·자막·효과음 트랙으로 나뉩니다. 샷을 선택해 문구·글자 크기·색을 고치고, 클립을 옮기거나 자르거나 속도를 바꾸고, 라이브러리의 150개 샷을 끌어다 넣은 뒤 Remotion으로 내보낼 수 있어요. 미리보기와 렌더링 결과는 프레임이 똑같습니다.

Motion Workbench

Workbench 가이드: 패널마다 스크린샷 포함(중국어) · 연동 규약

결과물

결과물내용
완성 영상MP4, 1920×1080, 30fps, h264, 음악과 사운드 디자인 포함
Remotion 프로젝트영상의 전체 소스예요. 모든 샷이 React 컴포넌트라서 직접 또는 에이전트가 바꿀 수 있어요
Motion Workbench영상을 건넨 뒤 열려요. 트랙, 인스펙터, 시간 조절, 샷 교체, 내보내기 (자세히)
JianYing 초안선택 사항이에요. 샷별 클립·자막·오디오 트랙이 나뉜 편집용 JianYing(중국판 CapCut) 프로젝트
SNS 게시선택 사항이고 요청했을 때만 해요. Upload-Post로 완성 영상을 TikTok, Instagram, YouTube, LinkedIn, X 등에 올려요. 캡션과 플랫폼을 확인하고 시험 실행(dry-run)을 거친 뒤 게시합니다(가이드)

그 밖에 재사용할 수 있는 Remotion 컴포넌트(2.5D 페이지 카메라, 자막, 플래시 컷, 숫자 롤링), Freesound 효과음 검색·다운로드 도구, 배경음악 5곡, 페이지 캡처 스크립트, 제작 방법 자체(캡처, 비주얼 디렉션, 스토리보드, 사운드 디자인, 비트 싱크, 최종 검수)가 references/에 들어 있어요.

쇼케이스

여러분의 영상을 공유해 주세요. video-shotcraft로 만든 영상이 있다면 쇼케이스 이슈 양식으로 제출하세요. 검토를 거치면 쇼케이스 페이지에 올라갑니다.

요구 사항

필요한 것용도
Node.js와 npmRemotion 렌더링, 템플릿, 워크벤치
ffmpeg / ffprobe프레임 확인과 최종 검수
uv배경음악 박자 분석에만 필요해요(파이썬 스크립트를 한 번 실행해요)
puppeteer페이지 캡처에만 필요해요. 캡처 스크립트가 필요할 때 설치해요

Remotion은 처음 렌더링할 때 자체 헤드리스 Chrome을 내려받아요. macOS에서 시험했고, Linux는 아래 안내대로 하면 됩니다.

헤드리스 Linux / CI 안내

헤드리스 Linux 환경(시험 환경: 2코어, Node 22)에서 렌더링하면 장벽이 세 가지 있어요.

  1. 동시 실행 수 제한. 코어가 적은 장비에서 remotion still/render가 "Maximum for --concurrency is 2"로 실패해요. --concurrency=1을 넘기세요.
  2. 옛 헤드리스 모드 제거. 최근 Chrome/Chromium에서 옛 헤드리스 모드가 없어져서, Remotion이 시스템 Chromium을 가리키면 실행에 실패해요. 전체 Chrome 대신 chrome-headless-shell 바이너리를 쓰세요.
  3. CDN 차단. remotion.media에 접속할 수 없으면(중국 본토에서 흔해요) 헤드리스 셸 자동 다운로드가 실패해요. --browser-executable=<경로>를 넘기세요.

이 세 가지 플래그를 쓰면 들어 있는 템플릿에서 프레임 렌더링이 됩니다.

저장소 구조
video-shotcraft/
├── SKILL.md                 # 에이전트 진입점과 핵심 제작 규칙
├── references/
│   ├── pipeline.md          # 처음부터 끝까지의 제작 워크플로
│   ├── shots/               # 기능별 10개 분류의 샷 레시피 카드 124장
│   ├── sequences/           # 재사용할 수 있는 전체 영상 구조와 시퀀스 패턴
│   ├── aesthetic-rules.md   # 시각 검수 기준
│   ├── music-beat-sync.md   # 배경음악 분석과 비트 싱크 방법
│   ├── sound-design.md      # 사운드 디자인 안내와 예시
│   ├── sfx-sourcing.md      # Freesound 검색, 다운로드, 분석, 출처 표기
│   ├── jianying-export.md   # JianYing(중국판 CapCut) 프로젝트 내보내기 가이드
│   ├── publish-upload-post.md # 선택: SNS 게시(Upload-Post API)
│   └── workbench.md         # Motion Workbench: 매니페스트 규약과 편집 가능 규칙
├── demos/                   # Remotion 참고 구현(같은 분류)
├── gallery/                 # 정적 모션 미리보기 갤러리
├── template/                # 바로 실행할 수 있는 완성 영상 템플릿
├── jianying-export/         # JianYing 초안 설치기(mac 시험 완료 / win 미시험)
├── publish/                 # 선택: SNS 게시기(표준 라이브러리만 쓰는 Python) + 오프라인 테스트
├── workbench/               # 영상 전달 뒤 쓰는 모션 워크벤치(Vite + Remotion Player)
└── assets/
    ├── lib/                 # 재사용 Remotion 컴포넌트
    ├── scripts/             # 페이지 캡처 + Freesound CLI와 오프라인 테스트
    └── audio/
        └── bgm/             # 배경음악 5곡. 효과음은 프로젝트마다 내려받아요

전체 워크플로는 SKILL.md, 제작 파이프라인, 시각 검수 기준을 보세요.

오디오와 에셋

효과음은 Freesound에서 바로 받아 영상 프로젝트마다 내려받아 둬요. 공용 효과음 라이브러리는 없앴습니다. 수집 가이드에 검색, CC0 / CC BY 거르기, MP3 미리듣기 내려받기, 측정, 출처·크레딧 목록 만드는 법이 있어요. 파이썬 CLI는 표준 라이브러리만 쓰고, 다운로드와 분석에는 FFmpeg가 필요합니다. API 키는 필요 없어요. 사운드 디자인은 타이밍과 믹싱을 다뤄요. 템플릿은 재생과 회귀 검사를 위해 예전 오디오를 그대로 두고, 새 제품 영상은 Freesound에서 효과음을 받아 써요. 배경음악 후보는 assets/audio/bgm/에 남아 있어요.

템플릿에 들어 있는 제품 스크린샷은 시연용 에셋입니다. 공개하기 전에 여러분 제품의 스크린샷으로 바꾸고, 제품·고객·개인 정보를 가려야 하는지 확인하세요.

라이선스

  • 코드와 문서: Apache-2.0.
  • Freesound 오디오: 파일마다 기록된 라이선스를 따르고, 프로젝트 매니페스트를 보관하며 CC BY 크레딧을 공개해야 해요.
  • 배경음악: ATTRIBUTION.md를 보세요. 예전 템플릿 오디오는 템플릿 크레딧을 보세요.
  • Remotion은 자체 라이선스가 있어요. 개인과 소규모 팀은 무료이고, 회사는 유료 라이선스가 필요할 수 있습니다.

감사의 말

많은 레시피는 훌륭한 공식 제품 영상의 모션 언어를 연구해 정리한 것입니다. ClickUp, Perplexity, Slack, Notion, Figma, Framer, Bear, Raycast, Pitch, Miro, Superhuman, Loom의 홍보 영상도 포함돼요. 카드는 기법(타이밍, 이징, 안무)을 처음부터 다시 구현해 기록한 것이고, 이 영상들의 영상 자료·아트워크·브랜드 에셋은 들어 있지 않습니다. 모든 상표는 각 소유자에게 있으며, 이 회사들은 이 프로젝트와 관련이 없고 보증하지도 않습니다.

Freesound 수집 흐름은 **vibe-motion/sound**에서 영감을 받았어요. 출처 설명, 길이, 다운로드 수, 평가 수, 라이선스로 소리를 고르는 방식을 공유해 준 제작자들에게 감사드립니다. Video Shotcraft의 검색·다운로드 CLI는 독립적으로 구현했습니다.

여기 있는 모든 데모와 템플릿을 구동하는 Remotion, 프로젝트 효과음을 제공한 **Freesound**와 기여자들, 배경음악과 예전 템플릿 오디오를 제공한 Mixkit, 여러 카드에 영감을 준 게임 필(game-feel)·애니메이션 커뮤니티, 그리고 이 스킬이 가르치는 것과 같은 워크플로로 라이브러리를 만들고 다듬고 검수한 Claude Code에도 감사드립니다.

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0