YouTube Production — 영상 콘텐츠 풀 프로덕션 파이프라인
YouTube 영상의 기획→대본→썸네일→SEO를 에이전트 팀이 협업하여 한 번에 생성한다.
실행 모드
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 |
파일 |
역할 |
타입 |
| content-strategist |
.claude/agents/content-strategist.md |
주제분석, 경쟁벤치마킹, 컨셉설계 |
general-purpose |
| scriptwriter |
.claude/agents/scriptwriter.md |
대본 작성, 시각 큐 삽입 |
general-purpose |
| thumbnail-designer |
.claude/agents/thumbnail-designer.md |
썸네일 컨셉 + 이미지 생성 |
general-purpose |
| seo-optimizer |
.claude/agents/seo-optimizer.md |
제목/설명/태그/챕터/자막 |
general-purpose |
| production-reviewer |
.claude/agents/production-reviewer.md |
교차 검증, 정합성 확인 |
general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 주제/키워드: 영상이 다룰 주제
- 채널 정보 (선택): 채널 톤, 구독자 규모, 기존 콘텐츠 방향
- 제약 조건 (선택): 영상 길이, 특정 요구사항
- 기존 파일 (선택): 사용자가 제공한 대본, 기획서 등
_workspace/ 디렉토리를 프로젝트 루트에 생성한다- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 기존 파일이 있으면
_workspace/에 복사하고 해당 Phase를 건너뛴다
- 요청 범위에 따라 실행 모드를 결정한다 (아래 "작업 규모별 모드" 참조)
Phase 2: 팀 구성 및 실행
팀을 구성하고 작업을 할당한다. 작업 간 의존 관계는 다음과 같다:
| 순서 |
작업 |
담당 |
의존 |
산출물 |
| 1 |
콘텐츠 전략 수립 |
strategist |
없음 |
_workspace/01_strategist_brief.md |
| 2a |
대본 작성 |
writer |
작업 1 |
_workspace/02_scriptwriter_script.md |
| 2b |
썸네일 설계·생성 |
designer |
작업 1 |
_workspace/03_thumbnail_concept.md |
| 3 |
SEO 패키지 |
seo |
작업 1, 2a |
_workspace/04_seo_package.md, _workspace/subtitle.srt |
| 4 |
프로덕션 리뷰 |
reviewer |
작업 2a, 2b, 3 |
_workspace/05_review_report.md |
작업 2a(대본)와 2b(썸네일)는 병렬 실행한다. 둘 다 작업 1(전략)에만 의존하므로 동시에 시작할 수 있다.
팀원 간 소통 흐름:
- strategist 완료 → writer에게 핵심 앵글·톤 전달, designer에게 제목 후보·감정 포인트 전달, seo에게 키워드 맵 전달
- writer 완료 → designer에게 훅 핵심 메시지 전달 (썸네일-훅 일관성), seo에게 대본 전달
- seo 완료 → designer에게 제목-썸네일 조합 피드백 전달
- reviewer는 모든 산출물을 교차 검증. 🔴 필수 수정 발견 시 해당 에이전트에게 수정 요청 → 재작업 → 재검증 (최대 2회)
Phase 3: 통합 및 최종 산출물
리뷰어의 보고서를 기반으로 최종 산출물을 정리한다:
_workspace/ 내 모든 파일을 확인한다- 리뷰 보고서의 🔴 필수 수정이 모두 반영되었는지 확인한다
- 최종 요약을 사용자에게 보고한다:
- 전략 브리프 —
01_strategist_brief.md
- 영상 대본 —
02_scriptwriter_script.md
- 썸네일 컨셉 + 이미지 —
03_thumbnail_concept.md
- SEO 패키지 —
04_seo_package.md
- 리뷰 보고서 —
05_review_report.md
- 자막 파일 —
subtitle.srt
작업 규모별 모드
사용자 요청의 범위에 따라 투입 에이전트를 조절한다:
| 사용자 요청 패턴 |
실행 모드 |
투입 에이전트 |
| "유튜브 영상 기획해줘", "풀 프로덕션" |
풀 파이프라인 |
5명 전원 |
| "대본만 써줘", "스크립트만" |
대본 모드 |
strategist + writer + reviewer |
| "이 대본으로 SEO 최적화해줘" (기존 파일) |
SEO 모드 |
seo + reviewer |
| "영상 썸네일 만들어줘" (기존 기획 있음) |
썸네일 모드 |
designer + reviewer |
| "이 대본 검토해줘" |
리뷰 모드 |
reviewer 단독 |
기존 파일 활용: 사용자가 대본, 기획서 등 기존 파일을 제공하면, 해당 파일을 _workspace/의 적절한 번호 위치에 복사하고 해당 단계의 에이전트는 건너뛴다. 예: 기존 대본 제공 → _workspace/02_scriptwriter_script.md로 복사 → writer 건너뛰고 seo·designer·reviewer만 투입.
데이터 전달 프로토콜
| 전략 |
방식 |
용도 |
| 파일 기반 |
_workspace/ 디렉토리 |
주요 산출물 저장 및 공유 |
| 메시지 기반 |
SendMessage |
실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 |
TaskCreate/TaskUpdate |
진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
에러 핸들링
| 에러 유형 |
전략 |
| 웹 검색 실패 |
전략가가 일반 지식 기반으로 작업, 보고서에 "데이터 제한" 명시 |
| 썸네일 이미지 생성 실패 |
텍스트 컨셉만으로 진행, Gemini 프롬프트 포함하여 사용자 재시도 가능 |
| 에이전트 실패 |
1회 재시도 → 실패 시 해당 산출물 없이 진행, 리뷰 보고서에 누락 명시 |
| 리뷰에서 🔴 발견 |
해당 에이전트에 수정 요청 → 재작업 → 재검증 (최대 2회) |
에이전트별 확장 스킬
| 스킬 |
경로 |
대상 에이전트 |
역할 |
| hook-writing |
skills/hook-writing/skill.md |
scriptwriter |
15가지 훅 패턴, 시청 유지율 심리학, 훅-썸네일-제목 삼각 정합성 |
| thumbnail-psychology |
skills/thumbnail-psychology/skill.md |
thumbnail-designer |
색상 심리학, 7가지 구도 패턴, 텍스트 가독성, 3초 테스트 |
에이전트는 자신의 작업 수행 시 해당 확장 스킬을 참조하여 도메인 전문성을 강화한다.
테스트 시나리오
정상 흐름
프롬프트: "AI 프롬프트 엔지니어링 초보자 가이드로 10분짜리 유튜브 영상을 기획해줘"
기대 결과:
- 전략 브리프: 경쟁 분석 3건 이상, 키워드 맵, 제목 후보 3개
- 대본: 10분 분량(약 2,500단어 한국어 기준), 훅+3~4세그먼트+클로징
- 썸네일: A/B안 컨셉 + 이미지 생성 시도
- SEO: 제목/설명/태그/챕터/SRT
- 리뷰: 정합성 매트릭스 전항목 확인
기존 파일 활용 흐름
프롬프트: "이 대본 파일로 SEO 최적화랑 썸네일 만들어줘" + 대본 파일 첨부
기대 결과:
- 기존 대본을
_workspace/02_scriptwriter_script.md로 복사
- SEO 모드 + 썸네일 모드 병합: seo + designer + reviewer 투입
- strategist, writer는 건너뜀
에러 흐름
프롬프트: "유튜브 영상 대본만 빨리 써줘, 주제는 아무거나"
기대 결과:
- 대본 모드로 전환 (strategist + writer + reviewer)
- 주제가 불분명하므로 전략가가 트렌드 기반 주제 3개 제안 후 진행
- 리뷰 보고서에 "썸네일/SEO 미생성" 명시
1---2name: youtube-production-23description: YouTube 영상 콘텐츠의 기획, 대본(스크립트), 썸네일, SEO 메타데이터를 에이전트 팀이 협업하여 한 번에 생성하는 풀 프로덕션 파이프라인. '유튜브 영상 기획해줘', '영상 대본 써줘', '영상 스크립트', '유튜브 콘텐츠 전략', '영상 시나리오', '유튜브 쇼츠 기획', 'YouTube 썸네일 만들어줘', '영상 SEO 최적화', '유튜브 채널 콘텐츠' 등 YouTube 영상 콘텐츠 제작 전반에 이 스킬을 사용한다. 기존 대본이 있는 경우에도 SEO 최적화나 썸네일 제작을 지원한다. 단, 실제 영상 편집(Premiere, DaVinci), 유튜브 Analytics API 연동, 채널 운영 대시보드 구축은 이 스킬의 범위가 아니다.4---56# YouTube Production — 영상 콘텐츠 풀 프로덕션 파이프라인78YouTube 영상의 기획→대본→썸네일→SEO를 에이전트 팀이 협업하여 한 번에 생성한다.910## 실행 모드1112**에이전트 팀** — 5명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| content-strategist | `.claude/agents/content-strategist.md` | 주제분석, 경쟁벤치마킹, 컨셉설계 | general-purpose |19| scriptwriter | `.claude/agents/scriptwriter.md` | 대본 작성, 시각 큐 삽입 | general-purpose |20| thumbnail-designer | `.claude/agents/thumbnail-designer.md` | 썸네일 컨셉 + 이미지 생성 | general-purpose |21| seo-optimizer | `.claude/agents/seo-optimizer.md` | 제목/설명/태그/챕터/자막 | general-purpose |22| production-reviewer | `.claude/agents/production-reviewer.md` | 교차 검증, 정합성 확인 | general-purpose |2324## 워크플로우2526### Phase 1: 준비 (오케스트레이터 직접 수행)27281. 사용자 입력에서 추출한다:29 - **주제/키워드**: 영상이 다룰 주제30 - **채널 정보** (선택): 채널 톤, 구독자 규모, 기존 콘텐츠 방향31 - **제약 조건** (선택): 영상 길이, 특정 요구사항32 - **기존 파일** (선택): 사용자가 제공한 대본, 기획서 등332. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다343. 입력을 정리하여 `_workspace/00_input.md`에 저장한다354. 기존 파일이 있으면 `_workspace/`에 복사하고 해당 Phase를 건너뛴다365. 요청 범위에 따라 **실행 모드를 결정**한다 (아래 "작업 규모별 모드" 참조)3738### Phase 2: 팀 구성 및 실행3940팀을 구성하고 작업을 할당한다. 작업 간 의존 관계는 다음과 같다:4142| 순서 | 작업 | 담당 | 의존 | 산출물 |43|------|------|------|------|--------|44| 1 | 콘텐츠 전략 수립 | strategist | 없음 | `_workspace/01_strategist_brief.md` |45| 2a | 대본 작성 | writer | 작업 1 | `_workspace/02_scriptwriter_script.md` |46| 2b | 썸네일 설계·생성 | designer | 작업 1 | `_workspace/03_thumbnail_concept.md` |47| 3 | SEO 패키지 | seo | 작업 1, 2a | `_workspace/04_seo_package.md`, `_workspace/subtitle.srt` |48| 4 | 프로덕션 리뷰 | reviewer | 작업 2a, 2b, 3 | `_workspace/05_review_report.md` |4950작업 2a(대본)와 2b(썸네일)는 **병렬 실행**한다. 둘 다 작업 1(전략)에만 의존하므로 동시에 시작할 수 있다.5152**팀원 간 소통 흐름:**53- strategist 완료 → writer에게 핵심 앵글·톤 전달, designer에게 제목 후보·감정 포인트 전달, seo에게 키워드 맵 전달54- writer 완료 → designer에게 훅 핵심 메시지 전달 (썸네일-훅 일관성), seo에게 대본 전달55- seo 완료 → designer에게 제목-썸네일 조합 피드백 전달56- reviewer는 모든 산출물을 교차 검증. 🔴 필수 수정 발견 시 해당 에이전트에게 수정 요청 → 재작업 → 재검증 (최대 2회)5758### Phase 3: 통합 및 최종 산출물5960리뷰어의 보고서를 기반으로 최종 산출물을 정리한다:61621. `_workspace/` 내 모든 파일을 확인한다632. 리뷰 보고서의 🔴 필수 수정이 모두 반영되었는지 확인한다643. 최종 요약을 사용자에게 보고한다:65 - 전략 브리프 — `01_strategist_brief.md`66 - 영상 대본 — `02_scriptwriter_script.md`67 - 썸네일 컨셉 + 이미지 — `03_thumbnail_concept.md`68 - SEO 패키지 — `04_seo_package.md`69 - 리뷰 보고서 — `05_review_report.md`70 - 자막 파일 — `subtitle.srt`7172## 작업 규모별 모드7374사용자 요청의 범위에 따라 투입 에이전트를 조절한다:7576| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |77|----------------|----------|-------------|78| "유튜브 영상 기획해줘", "풀 프로덕션" | **풀 파이프라인** | 5명 전원 |79| "대본만 써줘", "스크립트만" | **대본 모드** | strategist + writer + reviewer |80| "이 대본으로 SEO 최적화해줘" (기존 파일) | **SEO 모드** | seo + reviewer |81| "영상 썸네일 만들어줘" (기존 기획 있음) | **썸네일 모드** | designer + reviewer |82| "이 대본 검토해줘" | **리뷰 모드** | reviewer 단독 |8384**기존 파일 활용**: 사용자가 대본, 기획서 등 기존 파일을 제공하면, 해당 파일을 `_workspace/`의 적절한 번호 위치에 복사하고 해당 단계의 에이전트는 건너뛴다. 예: 기존 대본 제공 → `_workspace/02_scriptwriter_script.md`로 복사 → writer 건너뛰고 seo·designer·reviewer만 투입.8586## 데이터 전달 프로토콜8788| 전략 | 방식 | 용도 |89|------|------|------|90| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |91| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |92| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |9394파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`9596## 에러 핸들링9798| 에러 유형 | 전략 |99|----------|------|100| 웹 검색 실패 | 전략가가 일반 지식 기반으로 작업, 보고서에 "데이터 제한" 명시 |101| 썸네일 이미지 생성 실패 | 텍스트 컨셉만으로 진행, Gemini 프롬프트 포함하여 사용자 재시도 가능 |102| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 리뷰 보고서에 누락 명시 |103| 리뷰에서 🔴 발견 | 해당 에이전트에 수정 요청 → 재작업 → 재검증 (최대 2회) |104105## 에이전트별 확장 스킬106107| 스킬 | 경로 | 대상 에이전트 | 역할 |108|------|------|-------------|------|109| hook-writing | `skills/hook-writing/skill.md` | scriptwriter | 15가지 훅 패턴, 시청 유지율 심리학, 훅-썸네일-제목 삼각 정합성 |110| thumbnail-psychology | `skills/thumbnail-psychology/skill.md` | thumbnail-designer | 색상 심리학, 7가지 구도 패턴, 텍스트 가독성, 3초 테스트 |111112에이전트는 자신의 작업 수행 시 해당 확장 스킬을 참조하여 도메인 전문성을 강화한다.113114## 테스트 시나리오115116### 정상 흐름117**프롬프트**: "AI 프롬프트 엔지니어링 초보자 가이드로 10분짜리 유튜브 영상을 기획해줘"118**기대 결과**:119- 전략 브리프: 경쟁 분석 3건 이상, 키워드 맵, 제목 후보 3개120- 대본: 10분 분량(약 2,500단어 한국어 기준), 훅+3~4세그먼트+클로징121- 썸네일: A/B안 컨셉 + 이미지 생성 시도122- SEO: 제목/설명/태그/챕터/SRT123- 리뷰: 정합성 매트릭스 전항목 확인124125### 기존 파일 활용 흐름126**프롬프트**: "이 대본 파일로 SEO 최적화랑 썸네일 만들어줘" + 대본 파일 첨부127**기대 결과**:128- 기존 대본을 `_workspace/02_scriptwriter_script.md`로 복사129- SEO 모드 + 썸네일 모드 병합: seo + designer + reviewer 투입130- strategist, writer는 건너뜀131132### 에러 흐름133**프롬프트**: "유튜브 영상 대본만 빨리 써줘, 주제는 아무거나"134**기대 결과**:135- 대본 모드로 전환 (strategist + writer + reviewer)136- 주제가 불분명하므로 전략가가 트렌드 기반 주제 3개 제안 후 진행137- 리뷰 보고서에 "썸네일/SEO 미생성" 명시
revfactory