Communitygithub.com

CarVendors Video Studio v4

CarVendors.co.uk 동영상 제작을 위한 팀 스킬입니다. 약 200개의 기존 @bnf_cars TikTok 동영상을 대량으로 편집하여 CarVendors Reels/TikTok/YouTube Shorts로 재탄생시킵니다.

CarVendors Video Studio v4란 무엇인가요?

CarVendors Video Studio v4는 자동차 딜러 CarVendors.co.uk 및 B&F Cars Northampton의 소셜 미디어 동영상을 전문적으로 편집하는 AI 에이전트 스킬입니다. 주 목적은 기존 TikTok 동영상(약 200개)을 가져와 주의를 끄는 후크 → 한 번의 전환 → 원본 전체 → 아웃트로 구성된 브랜드화된 숏폼 동영상(Reels, TikTok, YouTube Shorts)으로 대량 재편집하는 것입니다. 이 스킬은 배치 스크립트(`batch.py` 및 `build.py`)를 통해 저렴하고 빠른 워크플로우를 제공하여, 각 동영상의 텍스트 스타일, 후크 선택, 오디오 레벨 및 QA를 처리합니다. Mac과 Windows 모두에서 작동하며, 공유 Google Drive 폴더를 통해 후크 사용 내역, 음악, 로고 및 아웃트로를 모든 PC에서 일관되게 유지합니다. 이 브랜드는 CarVendors 및 B&F Cars 전용이며, 다른 클라이언트에는 사용할 수 없습니다. 사용자는 '동영상 7 편집', '1-20 계획', '준비된 것 렌더링' 등 자연어 명령으로 작업을 지시할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delwerhossain/carvendors-video-studio/tree/HEAD/skills/carvendors-studio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

CarVendors Video Studio v4은(는) 무엇을 하나요?

사용자와 짧고 간단한 벵골어로 대화하세요. 동영상의 모든 내용은 영국 영어입니다. $CS = 이 스킬 폴더 (~/.claude/skills/carvendors-studio, Windows %USERPROFILE%\.claude\skills\carvendors-studio). $PY = 스킬의 Python: Mac ~/.cache/carvendors-studio/venv/bin/python, Windows %USERPROFILE%\.cache\carvendors-studio\venv\Scripts\python.exe (설치 시 생성, numpy + scipy 포함).

0. 절대 변하지 않는 규칙

  1. 사실을 지어내지 마세요. 가격, 주행거리, 엔진, 연식, "신규 입고", "판매 완료", 금융, 연비, 번호판은 증거가 있을 때만 언급하세요. 예전 TikTok 텍스트와 댓글은 증거가 아닙니다.
  2. 진짜는 진짜로. 실제 영상과 실제 쇼룸 사진만 사용하세요. AI로 만든 자동차, 사람, 쇼룸, 표지판은 금지입니다.
  3. 브랜드: CarVendors.co.uk가 메인 브랜드이며, "Featured dealer: B&F Cars"는 보조 브랜드입니다. CarVendors는 사람들이 자동차를 찾고 연결하도록 돕는 곳이며, 자동차를 판매하지는 않습니다. 두 곳 모두 저희 회사입니다.
  4. 전체 동영상, 균형 잡힌 길이: 원본 전체를 순서대로 유지하세요 (장면 편집 금지). 후크 하나와 아웃트로 하나를 추가하세요. 총 길이 ≈ 원본 + 3-7초. 검은색/정지/중복 프레임만 잘라내세요.
  5. 본질적으로 저렴하게: 빠른 경로 (batch.py + build.py)를 사용하세요. HTML 구성 파일을 직접 작성하지 말고, 후크를 다시 분석하지 마세요 (공유 카탈로그에 있음). 동영상당 하나의 콘택트 시트만 확인하세요. 막힐 때만 질문하세요.
  6. 절대 API 키를 인쇄하거나 복사하지 마세요 (~/.config/video-studio/.env). 내보내기 파일을 덮어쓰지 마세요 (_v2, _v3…).
  7. 무언가의 위치나 사용자의 의도가 확실하지 않으면 → $PY $CS/tools/paths.py show와 CarVendors Drive 폴더 (paths.py get carvendors — 모든 컨텍스트 포함: 소스, 로고, 쇼룸 사진, 배너, 고객 리뷰, 텍스트 스타일 미리보기)를 확인한 후 한 가지 짧은 질문을 하세요.

1. 파일 위치 (자동, Mac + Windows)

$PY $CS/tools/paths.py show는 이 PC의 Google Drive "My Drive"를 찾아 팀 설정 파일 My Drive/Projects/CarVendors/_studio/config.json을 읽습니다 (경로는 My Drive 기준 + 팀 기본값). Drive가 실행 중이면 설정이 필요 없습니다. 한 PC에서 재정의: paths.py set <key> <path> / paths.py drive <My Drive path>. 키: car_sources (video.mp4, comments.txt, 가끔 Voice/ 폴더가 있는 1-200번 폴더), hooks, bgm, sfx, fonts, logos, showroom_pics, text_refs, outros, exports (업로드용 완성된 동영상), studio (공유 카탈로그 + 원장), projects_root (로컬 작업 폴더, ~/Projects/videos).

2. 대량 반복 작업 (기본)

$PY $CS/tools/batch.py plan 1-20      # 작업 폴더 ~/Projects/videos/bnf-vNNN + 초안 job.json + 콘택트 시트 + 텍스트 상자
  → 각 동영상: work/qa/contact.jpg 확인, job.json 수정(§3), "ready": true 설정
$PY $CS/tools/batch.py render 1-20    # 준비된 모든 작업 빌드 및 렌더링, Drive로 내보내기, 후크 사용 기록 작성
$PY $CS/tools/batch.py status 1-200

단일 동영상 수동 처리: $PY $CS/tools/build.py <job.json> (확인만) → 선택 사항 npx hyperframes snapshot <job>/work/hf --at <t> → build.py <job.json> --render. 10-20개씩 배치로 작업하세요. 각 배치 후 프레임 시트(output/*_frames.jpg)를 확인하고 다음 배치로 넘어가세요.

3. 동영상별 결정 사항 (유일한 AI 작업)

콘택트 시트 + source_info + text_hint (job.json 내) 기반:

  • slug: 짧은 모델명, 예: mitsubishi-asx.
  • 텍스트 디자인: references/text-style.md를 정확히 따르세요 (text_refs의 미리보기 이미지 참조): 흰색 Montserrat Black 텍스트, 단일 포인트 색상 = 브랜드 레드 #E8202A 파일/태그, 흰색 카드에 짙은 회색 텍스트, 녹색은 작은 점/체크 표시에만 사용, 로고는 상단 중앙에 깔끔하게 배치. 영상 위에 짙은 회색/검은색 상자, 파일 또는 배지 사용 금지.
  • 이전 텍스트 (각 text_hint 상자, src = 소스 픽셀, canvas = 1080×1920 px), 가장 저렴한 좋은 옵션: 유지 (무해하고, 읽을 수 있고, 브랜드에 부합하며, 예: 일반 모델명) → covers[]로 덮기 (text-cover, 스타일 card = 흰색 카드 + 빨간색 키커 태그, canvas 좌표 기준, 항상 줄 포함, 예: 키커 "FEATURED" + "Spotted at B&F Cars") (가격, "TikTok", 다른 업체, 무례하거나 확인되지 않은 주장 표시 시) → remove[]로 제거 (src 상자, 인페인트) (덮개가 자동차를 가릴 경우에만). 빈 덮개는 금지.
  • 오버레이 (0-3개, 핵심 장면에만, 자동차 얼굴/배지/바퀴 위 절대 금지): 첫 장면에 label-card · 디테일 또는 실내 장면에 punch-text ("Iconic Abarth / [Style]", "Perfect for / [City Driving]", "Sporty / [Interior]") · 하늘이 비어 있을 때 hero-model (큰 "ABARTH / 595") · 클로즈업에 detail-line "In the / details.". 파일은 항상 브랜드 레드. 흰 구름/밝은 앞유리 위: 텍스트 이동 또는 lineBg 0.35-0.5 (부드러운 광채, 상자 없음). 시간은 메인 동영상 시작부터 초 단위입니다.
  • 후크: "auto" (가장 적게 사용된, 최근 N개 편집에서 사용되지 않은)로 남겨두세요. "car_hook": true는 Car Hooks 폴더용. 명명된 후크: {"file": "Car Hooks/Car Flip.mp4", "in": 0, "out": 3.2} — 전체 동작, 페이오프 후 데드 타임만 자르기. transition: cut (기본) · whip · flash · zoom — 정확히 하나.
  • 음성: ready_voiceover가 존재하고 사용자가 원하는 경우에만; 먼저 전사하고 사실을 확인하세요. 그 외 모든 것 (로고 배지, 음악, 아웃트로, 그레이딩)은 팀 기본값에서 가져오며, 이유 없이 재정의하지 마세요.

전체 필드 목록: tools/build.py의 독스트링. 예시: examples/job-v002.json.

4. 공유 후크, 아웃트로, 음악 (모든 PC에서 Drive를 통해 동일)

  • $PY $CS/tools/hooks.py list|stats|pick <id>|sheet <name>|scan — 모든 후크 카탈로그 (길이, 액션 피크, 제안된 in/out, 미리보기 스트립) 및 _studio/ledger/*.json의 사용 횟수. 후크 추가 후 scan 실행.
  • 아웃트로: 팀 아웃트로 동영상을 outros 폴더에 넣고 _studio/config.json의 defaults.outro_video에 설정하세요. 모든 새 빌드에서 이를 사용합니다. 그때까지는 실제 쇼룸 사진 아웃트로 (defaults.outro_photo)를 사용하세요.
  • 음악: 설정 파일의 defaults.music 목록 (라이브러리 트랙, 라이선스 확인됨, 게시물에 크레딧 표시). 로고: defaults.logo (logo-badge, clean 스타일, 상단 중앙 — 참조 디자인).

5. 동영상 완료 확인 전

build.py는 hyperframes check를 보고합니다. "Check passed"가 표시되어야 합니다 (위치 또는 lineBg로 대비 수정). 프레임 시트 확인: 이전 텍스트 제거 또는 덮기 완료, 자동차 위 텍스트 없음, 로고 읽기 가능, 후크 → 메인 컷이 깔끔하게 연결. 벵골어로 보고: 출력 경로, 사용된 후크, 덮거나 제거한 내용, 차단 사항. 요청 시 영국 영어 게시물 카피 제공 (NCS 트랙의 경우 음악 크레딧 줄 포함).

6. 필요할 때만 추가로 읽기

  • references/text-style.md — 텍스트 디자인 (팔레트, 타입, 일곱 가지 요소, 배치). 오버레이 전에 읽으세요.
  • references/components.md — 모든 컴포넌트의 변수 (label-card, punch-text, text-cover, logo-badge, hero-model, detail-line, shape-text, verified-feature, caption-line, localized-contrast, outro-real-showroom).
  • references/design.md — 전체 디자인 시스템, 색상, 타입 프리셋 (PUNCH / CINEMATIC), 이전 텍스트 처리 우선순위, 인간 편집자 마감, 컬러 그레이딩, 브랜드/주장.
  • references/audio.md — 음성 (ElevenLabs tools/tts.py, 동영상별 모델 선택, 이 작업에 사전 승인됨), 음악/SFX, 음량. references/quality.md — 품질 게이트 및 이력.
  • 새로운 광고를 처음부터 (스토리 + AI 장면 + 음성) 제작: 먼저 사용자와 계획 수립; 동일한 규칙 적용, build.py로 조립.

관련 스킬