Communitygithub.com

cgallic/kai-cmo-harness

풀스택 영상 제작: 스크립트부터 렌더링된 MP4까지. TikTok/YouTube/Reels에 최적화된 스크립트 생성과 Remotion 기반 AI 영상 렌더링, AI 음성 해설(Qwen3-TTS/ElevenLabs), 음악 생성(ACE-Step), 브라우저 기반 데모 녹화를 결합합니다. "비디오 만들어줘", "데모 영상", "제품 영상" 등 영상 생성 및 렌더링 요청에 사용하세요.

kai-cmo-harness란 무엇인가요?

이 스킬은 스크립트 작성 단계에서 최종 렌더링된 MP4 파일까지 완전한 영상 제작 워크플로우를 제공합니다. TikTok, YouTube, Reels 플랫폼에 최적화된 스크립트를 생성하고, Remotion을 활용하여 AI 기반 영상 렌더링을 수행합니다. Qwen3-TTS 또는 ElevenLabs를 통한 음성 해설, ACE-Step을 통한 배경 음악 생성, 그리고 Playwright 기반 브라우저 데모 녹화를 지원합니다. 프로젝트는 JSON 파일로 상태를 추적하여 세션 간 자동 재개 및 의도 조정이 가능하며, 변종 실험실을 통해 다양한 후크, 구조, CTA 변형을 테스트한 후 최종 렌더링에 들어갑니다. 브랜드 프로필(색상, 폰트, 로고)이 자동 적용되고, 사전 조건 확인(Node.js, FFmpeg, Modal/RunPod 클라우드 도구)을 통해 안정적인 파이프라인을 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgallic/kai-cmo-harness/tree/HEAD/harness/skills-v2/kai-video-production

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

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

문서

/kai-video-production — 렌더링할 가치가 있는 스크립트에서 시작한 MP4 영상

Kai 루트 노트: 이 스킬의 knowledge/, harness/, scripts/ 경로는 사용자 프로젝트가 아닌 Kai 설치 폴더에 있습니다. knowledge/ 폴더를 포함하는 SKILL.md의 첫 번째 상위 디렉토리(Kai 플러그인 루트, ~/.claude/kai 또는 kai-cmo-harness 리포지토리)를 기준으로 확인하세요. MARKETING.md, memory/ 및 출력 파일은 현재 프로젝트에 있습니다. 참조된 scripts/ 명령어가 이 설치 환경에 없으면 그렇게 말하고 건너뛰고 파일 기반 안내를 계속하세요. 절대 존재하지 않는 출력을 지어내지 마세요.

스튜디오급 모션 스팟 (코드로 렌더링된 화제 출시 스팟, 실제 스크린샷 기반 워크스루, 또는 사이트용 페인 포인트 비디오 — 드롭 컷으로 리빌)은 /kai-motion-spot을 사용하세요. 이 스킬은 Remotion 템플릿 제작을 다룹니다.

목표

완성된 영상: 승인된 스크립트, 필요한 에셋, 동기화된 오디오, 플랫폼 사양에 맞는 렌더링된 MP4 — project.json은 디스크 상의 실제 프로젝트 상태를 설명하므로 다음 세션에서 재구성 없이 이어갈 수 있습니다.

제작은 좋은 스크립트를 증폭시키지만 나쁜 스크립트를 구할 수는 없습니다. 스크립트 품질은 어떤 에셋도 생성되기 전에 확정됩니다. 범위는 세 가지로 나뉩니다: 스크립트만 (스크립트에서 중단, 사용자 녹화), 자동화 제작 (전체 렌더링 파이프라인), 하이브리드 (음성 해설 및 슬라이드 생성, 사용자가 데모 제공).

완료 조건

작업 유형 social-post — 최소 E5/C2/O3 (harness/eco-floors.yaml), 계약 harness/skill-contracts/social-post.yaml. 유료 크리에이티브로 실행될 렌더링은 대신 paid-ad-campaign (E5/C4/O4)을 따르며, 크리에이티브가 제출되기 전에 플랫폼 정책 참조가 로드되어야 합니다.

  • E5 — 영상이 대상 플랫폼에 게시되었고, 비-배우가 승인된 컷에 대해 퍼머링크를 다시 읽었습니다. out/의 MP4는 E1입니다; 승리 변형과 최종 컷에 대한 인간 승인은 E3입니다. 이 스킬은 렌더링만 수행하고 업로드하지 않습니다.
  • C2 — banned_word_check 및 four_us_score (10/16)가 스크립트에서 깨끗하고, 아래 두 렌더링 체크리스트도 통과해야 합니다.
  • O3 — 게시 전에 기록된 기준선과 비교하여 7일 후 플랫폼 인사이트에서 도달, 참여율, 프로필 클릭, 링크 클릭을 읽습니다.

렌더링 전: 강력한 후크와 AI 슬롭 없는 스크립트 승인 · 모든 에셋 존재, 누락된 데모나 이미지 없음 · 장면 지속 시간이 내레이션과 일치 · 음성 해석이 시각 자료와 정렬 · 브랜드 색상, 폰트, 로고 정확 · 전환 부드러움 · 텍스트 대비 및 크기 읽기 가능 · Remotion Studio에서 미리보기 확인.

렌더링 후: 지정된 해상도 · 음악 위에 음성 해석이 들림 · 파일 크기가 플랫폼 제한 이내 · 형식이 대상 플랫폼에서 재생됨.

제약 사항

  • 변형 실험실에서 전체 렌더링으로 넘어가려면 인간 승인이 필요합니다. 렌더링은 컴퓨팅 시간과 비용이 들며, 승인되지 않은 컨셉은 둘 중 하나도 받을 수 없습니다.

  • 에셋 생성 또는 렌더링 전에 사전 점검 변형 실험실을 실행합니다. — 후크 변형 3개 (각각 플랫폼, 예상 첫 프레임 시각, 시청자 약속 포함), 장면 순서 또는 템포에 대한 구조 변형 2개, 캠페인 목표에 맞춘 CTA 변형 2개, 그리고 변형당 하나의 위험 노트 (지원되지 않는 주장, 브랜드 부적합, 승인 필요 사항 포함). workspace/video/projects/{name}/PREFLIGHT-VARIANTS.md에 작성하고, 하나의 승자를 선택하고, 거부된 변형은 같은 파일에 제거 목록으로 남겨둡니다.

    요소점수질문
    후크 강도1-5오프닝이 즉각적인 주의를 끌 수 있습니까?
    메시지 명확성1-5한 번 본 후 핵심 아이디어가 명확합니까?
    증거 밀도1-5주장이 데모, 인용, 데이터 또는 출처로 뒷받침됩니까?
    제작 적합성1-5가용 자산과 일정으로 제작 가능합니까?
    브랜드 안전성1-5가짜 권위, 위험한 주장, 또는 불명확한 권리를 피합니까?
  • 사용자에게 질문하기 전에 프로젝트 루트에서 MARKETING.md를 읽으십시오. 파일이 없으면 코드베이스(CLAUDE.md, README.md, PROJECT.md, package.json, 랜딩 페이지, 이메일/광고/분석 설정)를 사용하여 /kai-email-system의 템플릿으로 작성하고 초안을 확인합니다.

  • 제작 전에 다음을 알아야 합니다: 주제, 플랫폼, 형식(토킹 헤드, 화면 녹화, B-롤, 애니메이션, 슬라이드), 길이 대역, 목표, 그리고 사용자가 스크립트만 원하는지 전체 렌더링을 원하는지 여부.

  • 파일 시스템이 진실의 원천입니다. 재개 시 프로젝트 디렉토리를 스캔하고 project.json과 비교하여 상태를 수정합니다 — 파일이 존재하는 asset-needed은 asset-present가 되고, 파일이 누락된 ready는 asset-missing이 됩니다. 모든 불일치를 사용자에게 알리고 렌더링으로 무시하지 마십시오. 조정 후 프로젝트의 CLAUDE.md 상태 문서를 다시 생성합니다.

  • 브랜드 프로필이 자동 적용됩니다. 색상, 폰트, 로고는 brands/{brand}/brand.json에서, 음성 설정은 voice.json에서 가져옵니다. 브랜드 파일이 이미 정의한 색상이나 폰트를 인라인으로 다시 지정하지 마십시오.

  • 사전 조건은 실제 장애물입니다: Node.js 18+ (Remotion) 및 FFmpeg (인코딩)이 필요합니다. 클라우드 AI 기능은 Modal 계정(월 $30 무료 컴퓨팅) 또는 RunPod(초당 과금)가 필요합니다; ElevenLabs는 프리미엄 음성에 선택 사항입니다. /video-setup이 구성을 처리합니다. 이 설치 환경에 도구가 배포되지 않은 경우, 그렇게 말하고 — 출력을 생성하지 않은 도구의 출력을 절대 설명하지 마십시오.

  • 무료 또는 저렴한 도구를 선호합니다. Qwen3-TTS와 ACE-Step이 대부분의 작업을 처리하며, 프리미엄 제공자는 명시적 선택이지 기본값이 아닙니다.

  • 아무것도 게시하지 않습니다. 렌더링 결과는 out/에 저장되며, 업로드는 별도의 승인된 단계입니다.

컨텍스트

필요 사항로드 / 실행
영상 콘텐츠 메커니즘knowledge/playbooks/video-content-creation.md
TikTok · YouTube · Reelsknowledge/channels/tiktok-algorithm.md · knowledge/channels/youtube.md · knowledge/channels/instagram.md
슬라이드-장면 디자인 다듬기knowledge/frameworks/design/frontend-design.md
제품, ICP, 음성, 채널MARKETING.md (프로젝트 루트)
설정, 녹화, 오디오, 리뷰, 디자인, 클로닝/video-setup · /record-demo · /generate-voiceover · /scene-review · /design · /voice-clone

템플릿: product-demo (제목, 문제, 해결책, 데모, CTA) · explainer (제목, 개요, 섹션, 요약) · demo-walkthrough (내레이션이 있는 화면 녹화) · social-short (15~60초 세로형) · testimonial (인용 + 시각 자료) · announcement (런칭, 릴리스, 뉴스). 참고 자료는 함께 제공됩니다 — templates/product-demo/, templates/explainer/, templates/social-short/, 그리고 완성된 예제는 examples/digital-samba-skill-demo/ 및 examples/schlumbergera/에 있으며, 각각 소스, 렌더링된 MP4 및 제작 노트가 포함되어 있습니다.

프로젝트 구조:

projects/{name}/
├── project.json          # 상태, 장면, 에셋, 세션
├── VOICEOVER-SCRIPT.md   # 전체 내레이션
├── src/                  # Root.tsx, scenes/, config/ (타이밍, 브랜드, 에셋)
├── public/               # audio/, demos/, images/, videos/
└── CLAUDE.md             # 자동 생성 상태

project.json은 name, template, brand, created, updated, phase, scenes[] 배열 (id, type, duration, visual, narration, status), audio 블록 (voiceover: file/status/provider/speaker; music: file/status/preset), estimates.totalDurationSeconds, 그리고 sessions[] 로그 (날짜, 단계, 요약)를 포함합니다. 생명주기: planning → assets → review → audio → editing → rendering → complete.

장면 유형: title · overview · demo · split-demo · problem · solution · feature · stats · testimonial · cta · credits.

에셋. 슬라이드 (제목 카드, 불릿, 통계 시각화, CTA 화면)는 브랜드 프로필에서 생성됩니다. 데모는 /record-demo (Playwright 브라우저 녹화, --script demo-script.md --auto로 스크립트 자동화), public/demos/에 드롭된 외부 MP4/MOV, 또는 Playwright 스크린샷에서 가져옵니다. 이미지: python tools/flux2.py --prompt "..." --cloud modal로 생성, python tools/image_edit.py --input photo.jpg --style ...로 편집.

오디오.

python tools/voiceover.py --provider qwen3 --speaker Ryan --script VOICEOVER-SCRIPT.md --scene-dir public/audio/scenes --json
python tools/voiceover.py --provider elevenlabs --voice-id {ID} --script VOICEOVER-SCRIPT.md
python tools/music_gen.py --preset corporate-bg --duration 120 --bpm 90 --key "D Minor"
python tools/music.py --prompt "Upbeat corporate" --duration 120
python tools/sfx.py --preset whoosh   # also: pop, success

Qwen3 화자: Ryan, Brad, Ava, Lily, Emily, Sam, Alex, Kevin, Zoe. 음악 프리셋: corporate-bg, upbeat-intro, dramatic-reveal, ambient-subtle, tension-build, inspirational-montage, tech-minimal, celebration-end. /voice-clone은 맞춤 브랜드 음성을 생성합니다.

브랜드 파일. brand.json: colors (KaiCalls 예시에서 primary #3B82F6, secondary #10B981, background #111827, text #F9FAFB), fonts.heading / fonts.body (family + weight), logo, style. voice.json: provider, speaker, tone, pace, 그리고 elevenlabs 블록 (voice_id, stability, similarity_boost).

전환 — 7개의 커스텀 전환 + 4개의 Remotion 공식 전환, @/lib/transitions에서 임포트:

전환효과사용 사례
glitch()디지털 왜곡 + RGB 시프트기술 미학
rgbSplit()색수차에너제틱 컷
zoomBlur()방사형 모션 블러극적인 리빌
lightLeak()시네마틱 렌즈 플레어프로페셔널한 마무리
clockWipe()방사형 스윕 리빌시간 기반 콘텐츠
pixelate()디지털 모자이크레트로/8비트
checkerboard()그리드 리빌 (9가지 패턴)깔끔한 기하학
slide() fade() wipe() flip()공식 Remotion표준, 부드러움, 방향성, 장난기

리뷰 및 렌더링.

cd projects/{name} && npm run studio     # localhost:3000에서 Remotion Studio
npm run render -- --quality=low          # 미리보기
npm run render                           # 최종 → out/{name}.mp4

렌더링 옵션: --codec=h264 (기본값) 또는 h265 (더 작은 용량) · --resolution=1080p (기본값) 또는 720p · --fps=30 (기본값) 또는 60. 타이밍 조정은 config.ts에서 합니다.

후반 작업: tools/addmusic.py (기존 MP4에 음악 추가) · tools/redub.py (음성 교체) · tools/dewatermark.py --preset sora --cloud modal · tools/upscale.py --scale 2x --cloud modal.

클라우드 GPU. Modal은 /video-setup을 통해 배포: qwen3_tts ($0.01/영상), flux2 ($0.02/이미지), music_gen ($0.05/트랙), sadtalker ($0.10/영상), ltx2 ($0.23/클립), image_edit ($0.03/이미지), upscale ($0.01/이미지), dewatermark ($0.10/영상). RunPod는 초당 과금 대안입니다 (python tools/<tool>.py --setup 도구별). 60~90초 영상은 총 약 $0.20입니다 — 스크립트 ~$0.10, Qwen3 음성 해설 ~$0.01, ACE-Step 음악 ~$0.05, FLUX.2 이미지 ~$0.04, 로컬 Remotion 렌더링 $0.00. 프리미엄 추가: ElevenLabs 음성 해설 +$0.30, LTX-2 클립 +$0.23, SadTalker +$0.10. Modal의 스타터 무료 티어는 월 100개 이상의 영상을 처리합니다.

출력은 workspace/video/에 저장됩니다: _video-projects.md (인덱스), projects/{name}/ (out/{name}.mp4 포함), scripts/는 tiktok/, youtube/, reels/로 분할, 그리고 _production-guide.md.

진입점: /kai-video script --platform tiktok --topic "..." (스크립트만) · /kai-video produce --template product-demo --brand kaicalls (전체 파이프라인) · /kai-video resume {name}. 하위 스킬: /kai-repurpose (클립), /kai-social (스케줄링), /kai-content-calendar (릴리스 타이밍), /kai-analytics (성과).

일반적인 실패: "asset not found" — project.json 경로가 파일 시스템과 일치하지 않음, 조정 필요 · "audio out of sync" — config.ts 타이밍 조정 또는 현재 스크립트에 맞춰 음성 해설 재생성 · "render fails" — ffmpeg -version 확인, 에셋 존재 확인, 먼저 저품질 미리보기 실행 · "tool timeout on Modal" — 컴퓨팅 크레딧 및 modal app list 확인, 또는 RunPod로 폴백 · "brand colors not applied" — brand.json이 brands/에 없음, project.json의 브랜드 이름 불일치, 또는 src/config/brand.ts 재생성 필요.

에스컬레이션 시점

  • 변형 실험실 승자가 아직 승인되지 않았고 다음 단계가 렌더링 또는 GPU 컴퓨팅을 소비하는 경우.
  • 데모 푸티지에 고객 데이터, 타사 UI, 또는 권한이 확인되지 않은 모든 것이 포함된 경우.
  • 내레이션의 주장에 출처가 없는 숫자가 필요한 경우.
  • 조정 결과 프로젝트가 예상하지 못한 에셋이 발견되거나, 예상 에셋이 사라진 경우.
  • 사전 조건이 누락되었고(Node 18+, FFmpeg, 배포된 클라우드 도구 없음) 사용자가 렌더링된 파일을 기대하는 경우.
  • 영상이 유료 게재를 위한 것인 경우 — 제출 전에 플랫폼 정책 참조 및 paid-ad-campaign 최소 기준이 적용됩니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬