Communitygithub.com

cgallic/kai-cmo-harness

TikTok, YouTube Shorts, Instagram Reels 및 장形式 YouTube용 동영상 스크립트와 클리핑 플랜을 제작합니다. 후크 우선 스크립트를 각 플랫폼 알고리즘에 맞게 최적화하고, 장形式 콘텐츠에서 숏폼을 추출하기 위한 클리핑 플랜을 생성합니다.

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

이 스킬은 소셜 플랫폼용 동영상 스크립트와 클리핑 플랜을 생성하는 AI 에이전트(Claude Code, Cursor, Codex 등)를 위한 전문 도구입니다. '동영상 스크립트', 'TikTok 스크립트', 'YouTube 스크립트', 'Reels 스크립트', 'Shorts 스크립트', '클리핑 플랜', '동영상 아이디어' 등의 요청이 들어올 때 활성화됩니다. 후크 우선 접근법을 기반으로 각 플랫폼(TikTok, YouTube Shorts/장形式, Instagram Reels)의 알고리즘에 최적화된 스크립트를 작성하며, 장形式 동영상에서 숏폼 콘텐츠를 추출하기 위한 클리핑 플랜까지 제공합니다. 에이전트는 먼저 프로젝트 루트의 `MARKETING.md` 파일을 읽고, 없다면 코드베이스에서 자동으로 생성합니다. 각 플랫폼별 알고리즘 가이드(예: `knowledge/channels/tiktok-algorithm.md`)를 로드하여 최신 노름, 해시태그, 길이 제한을 반영합니다. 또한, 스크립트에는 후크(0~3초), 본문(3~45초), CTA(마지막 3~5초), 시각적 방향, 타임스탬프 오버레이 텍스트, 플랫폼 적합 해시태그, 트렌드 오디오 추천이 포함됩니다. 클리핑 플랜은 각 클립을 5가지 요소(후크, 독립적 명확성, 증거, 텐션, 출처 안전성)로 점수화하여 18/25 이상만 프로덕션 후보로 선정하고, 나머지는 킬 리스트에 기록합니다.

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

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

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

문서

/kai-video — 촬영 가능한 스크립트와 방어 가능한 클립 목록

Kai 루트 노트: 이 스킬의 knowledge/, harness/, scripts/ 경로는 사용자 프로젝트가 아닌 Kai 설치 디렉토리에 있습니다. knowledge/ 폴더를 포함하는 이 SKILL.md의 첫 번째 상위 디렉토리(Kai 플러그인 루트, ~/.claude/kai, 또는 kai-cmo-harness 저장소)를 기준으로 해석하십시오. MARKETING.md, memory/, 및 모든 출력 파일은 현재 프로젝트에 있습니다. 참조된 scripts/ 명령어가 이 설치에서 사용 가능하지 않은 경우, 그렇게 말하고 건너뛰며 파일 기반 안내를 계속 진행하십시오. 결코 명령어의 출력을 조작하지 마십시오.

목표

후속 질문 없이 누구나 촬영할 수 있는 스크립트와, 장形式 콘텐츠가 존재하는 경우 어떤 순간이 어떤 타임스탬프에서 숏폼이 되어야 하며 그 이유는 무엇인지 명명하는 클리핑 플랜을 제공합니다. 후크 우선 및 플랫폼 특화: 처음 3초가 나머지 작업의 중요성을 결정합니다.

완료 조건

작업 유형 social-post — 기준 E5/C2/O3 (harness/eco-floors.yaml), 계약 harness/skill-contracts/social-post.yaml.

  • E5 — 동영상이 게시되었고, 비배우가 승인된 스크립트와 컷에 대해 공개 퍼머링크를 읽고 확인했습니다. workspace/의 스크립트 파일은 E1입니다. 정확한 스크립트 승인은 E3입니다. 이 스킬은 아티팩트까지 도달합니다. 게시는 별도의 승인된 단계입니다.
  • C2 — 스크립트 사본에 대해 four_us_score가 10/16이고 banned_word_check가 깨끗하며, 아래 스크립트별 기준을 충족합니다.
  • O3 — 게시 전에 기록된 기준선 대비 7일차 플랫폼 인사이트에서 도달, 참여율, 프로필 클릭, 링크 클릭을 읽습니다.

스크립트별 기준: 후크가 처음 3초 내에 위치(인트로, "안녕하세요 여러분", 로고 애니메이션 없음) · 숏폼 동영상당 하나의 아이디어 · 금지 단어 및 AI 슬롭(slop) 제로 · 자연스럽게 마무리되는 CTA · 단어만이 아닌 시각적 방향 포함 · 플랫폼에 적합한 길이.

제약 사항

  • 사용자에게 질문하기 전에 프로젝트 루트에서 MARKETING.md를 읽으십시오. 존재하지 않는 경우, CLAUDE.md, README.md, PROJECT.md, package.json, 랜딩 페이지, 이메일/광고/애널리틱스 설정 등 코드베이스에서 템플릿(/kai-email-system)을 사용하여 빌드하고 초안을 확인하십시오.
  • 스크립팅 전에 다음을 알아야 합니다: 주제, 대상 플랫폼, 형식(토킹 헤드, 스크린 녹화, B-롤, 애니메이션), 길이 대역(숏폼 1560초 또는 장形式 515분), 목표, 및 적용할 기존 콘텐츠.
  • 해당 플랫폼용으로 작성하기 전에 플랫폼 가이드를 로드하십시오 — 알고리즘이 다르며 페이싱 규칙이 이전 가능하지 않습니다.
  • 모든 클립 행에는 소스 타임스탬프 또는 파일 로케이터가 포함됩니다. 소스가 게스트, 고객, 팟캐스트 또는 타사 쇼인 경우, 내보내기 전에 승인 상태를 표시하고 harness/references/transcript-video-research-rules.md를 따르십시오.
  • 클립 플랜은 드라이 런(dry run)입니다. 게시 또는 업로드는 사람의 승인이 필요합니다.
  • 슬레이트(slate) 전체에서 후크 공식을 다양화하십시오. 하나의 공식을 반복하면 시청자가 건너뛰도록 훈련됩니다.

컨텍스트

필요 사항로드 위치
동영상 콘텐츠 제작 메커니즘knowledge/playbooks/video-content-creation.md
TikTokknowledge/channels/tiktok-algorithm.md
YouTube (Shorts 및 장形式)knowledge/channels/youtube.md
Instagram Reelsknowledge/channels/instagram.md
장形式에서 숏폼으로 클리핑knowledge/playbooks/video-clipping-automation-workflow.md
모든 대본, 자막, 팟캐스트, 웨비나, 타사 소스harness/references/transcript-video-research-rules.md
제품, ICP, 음성, 채널MARKETING.md (프로젝트 루트)

숏폼 스크립트 (15~60초) 포함: 플랫폼, 길이, 형식, 후크(03초, 패턴 인터럽트 — 질문, 대담한 주장, 또는 시각적 놀라움), 본문(345초, 하나의 아이디어와 하나의 핵심 내용, 대괄호 안 시각적 방향 포함), CTA(마지막 35초), 타임스탬프가 있는 화면 텍스트 오버레이, 플랫폼에 적합한 해시태그 35개, 트렌드 오디오 추천 또는 "원본 오디오".

장形式 스크립트 (5~15분) 포함: 후크(030초, 보상 미리보기), 인트로(30초1분: 컨텍스트, 신뢰성, 구조 약속), 시각적 방향이 포함된 세 개의 콘텐츠 섹션, 요약 + CTA, 챕터 타임스탬프, 썸네일 컨셉(제목 텍스트 3~5단어, 표정, 핵심 시각).

후크 공식 — 슬레이트 전체에서 순환:

유형공식예시
질문"[놀라운 사실]을 알고 계셨나요?""영업 리드의 73%가 업무 시간 후에 전화한다는 사실을 알고 계셨나요?"
대담한 주장"[역설적 주장]""콜드 이메일은 죽었습니다. 이를 대체한 것이 있습니다."
문제"[X]로 어려움을 겪고 계신다면...""랜딩 페이지 전환율이 3% 미만이라면..."
결과"[나쁨]에서 [좋음]으로 [시간] 만에""3주 만에 전환율 2%에서 11%로"
목록"[숫자]가지 [것]으로 [결과]""모든 SaaS가 첫날에 필요한 5가지 이메일"

클립 점수화 — 스크립팅 전에 각 후보를 1~5점으로 평가:

요소질문
후크처음 3초가 계속 볼 명확한 이유를 만드는가?
독립적 명확성전체 소스 없이도 시청자가 순간을 이해할 수 있는가?
증거구체적인 예, 결과, 인용문 또는 데모 순간을 포함하는가?
텐션대비, 놀라움, 반대, 이해 관계 또는 공개를 포함하는가?
출처 안전성주장이 출처가 있고 사용이 허가되었는가?

18/25 이상 점수의 클립은 프로덕션 후보입니다. 더 낮은 점수는 이유와 함께 workspace/video/clipping-plan/_kill-list.md로 이동합니다.

출력은 workspace/video/로 이동: _video-plan.md, short-form/ (플랫폼별 스크립트), long-form/, clipping-plan/clips-from-[source].md, _quality-report.md.

에스컬레이션 시점

  • 소스 영상 권리, 게스트 승인, 또는 클립에 대한 고객 허가가 확인되지 않은 경우.
  • 스크립트의 주장에 출처가 없는 숫자가 필요한 경우.
  • 요청된 길이 또는 형식이 로드된 채널 가이드의 플랫폼 현재 규범과 충돌하는 경우.
  • 사용자가 스크립트 대신 동영상 렌더링을 원하는 경우 — 그 경우 /kai-video-production.
  • 인간 승인 없이 업로드되거나 게시될 경우.

Individual skills in this repo

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

관련 스킬