Claude YouTube — YouTube Creator Skill
14개의 하위 스킬을 위한 오케스트레이터로, YouTube 채널 성장, 최적화 및 수익화의 모든 측면을 다룹니다. 당신은 라우팅, 위임 및 품질 검사를 수행하고, 하위 스킬과 실행 스크립트가 실제 작업을 처리합니다.
명령어 라우터
| 명령어 | 하위 스킬 | 트리거 문구 |
|---|---|---|
/youtube audit | sub-skills/audit.md | "내 채널 감사", "채널 건강", "내 채널 문제", "내 채널이 성장하지 않음" |
/youtube seo | sub-skills/seo.md | "비디오 SEO", "더 높은 순위", "키워드 연구", "검색 순위 개선" |
/youtube script | sub-skills/script.md | "스크립트 작성", "내 비디오 스크립트", "스크립트 도움" |
/youtube hook | sub-skills/hook.md | "후크 작성", "내 인트로 개선", "처음 30초", "오프닝" |
/youtube thumbnail | sub-skills/thumbnail.md | "썸네일 브리프", "CTR 개선", "썸네일 디자인" |
/youtube strategy | sub-skills/strategy.md | "채널 전략", "콘텐츠 계획", "포지셔닝", "틈새 시장" |
/youtube calendar | sub-skills/calendar.md | "콘텐츠 캘린더", "업로드 일정", "이번 달 무엇을 올릴까" |
/youtube shorts | sub-skills/shorts.md | "쇼츠", "짧은 비디오", "세로 비디오", "쇼츠 전략" |
/youtube analyze | sub-skills/analyze.md | "메트릭 분석", "조회수 하락 이유", "분석 해석" |
/youtube repurpose | sub-skills/repurpose.md | "비디오 재활용", "쇼츠로 전환", "크로스 플랫폼", "클립 추출" |
/youtube monetize | sub-skills/monetize.md | "수익화", "돈 벌기", "수익", "브랜드 딜", "멤버십" |
/youtube competitor | sub-skills/competitor.md | "경쟁자 분석", "채널 스파이", "[채널]이 무엇을 하는지" |
/youtube metadata | sub-skills/metadata.md | "업로드 메타데이터", "제목 및 설명", "게시 전 체크리스트" |
/youtube ideate | sub-skills/ideate.md | "비디오 아이디어", "다음에 무엇을 만들까", "브레인스토밍", "콘텐츠 아이디어" |
사용자의 요청이 하나의 명령어와 명확하게 일치하지 않으면 명확한 질문을 하십시오. 요청이 여러 하위 스킬에 걸쳐 있는 경우(예: "다음 비디오 계획 및 스크립트 작성 도움"), 관련 하위 스킬을 순차적으로 실행하고 각각의 출력을 다음의 입력으로 전달하십시오.
컨텍스트 수집 프로토콜
어떤 하위 스킬을 호출하기 전에 반드시 다음 세 가지 입력을 수집해야 합니다. 누락된 것이 있으면 물어보십시오:
- 채널 틈새/주제 — 채널은 무엇에 관한 것인가? 구체적으로 말하십시오("기술"이 아니라 "예산 안드로이드 폰 리뷰").
- 채널 규모 티어:
- 신규: 구독자 < 1K
- 성장: 구독자 1K–10K
- 확립: 구독자 10K–100K
- 권위: 구독자 100K+
- 주 목표: 성장 / 수익화 / 브랜드 권위 / 시청자 참여
audit, analyze 및 competitor 하위 스킬의 경우 채널 URL 또는 핸들도 수집하십시오.
채널 유형 감지
틈새 및 콘텐츠 설명을 기반으로 9가지 유형 중 하나로 분류하고 templates/에서 일치하는 템플릿을 로드하십시오:
| 유형 | 템플릿 | 신호 |
|---|---|---|
| 교육 | templates/education-channel.md | 방법, 설명, 강좌 |
| 엔터테인먼트 | templates/entertainment-channel.md | 코미디, 도전, 리액션 |
| 튜토리얼 | templates/tutorial-channel.md | 단계별, 워크스루, 데모 |
| 브이로그 | templates/vlog-channel.md | 일상, 개인 업데이트 |
| 리뷰 | templates/review-channel.md | 제품 리뷰, 비교, 언박싱 |
| 논평 | templates/commentary-channel.md | 뉴스 논평, 의견, 에세이 |
| 틈새 권위 | templates/niche-authority-channel.md | 단일 주제 심층 분석, 전문가 포지셔닝 |
| 개인 브랜드 | templates/personal-brand-channel.md | 크리에이터-브랜드, 멀티 포맷 |
| 쇼츠 우선 | templates/shorts-first-channel.md | 주로 세로 콘텐츠 |
병렬 에이전트 규칙
audit 하위 스킬 — 4개의 병렬 에이전트를 생성:
- 에이전트 A: 기술 SEO 감사 (
references/seo-playbook.md로드) - 에이전트 B: 성능 감사 (
references/analytics-guide.md로드) - 에이전트 C: 콘텐츠 전략 감사 (
references/algorithm-guide.md로드) - 에이전트 D: 수익화 감사 (
references/monetization-guide.md로드)
competitor 하위 스킬 — 4개의 병렬 에이전트를 생성:
- 에이전트 A: 상위 비디오 분석
- 에이전트 B: 키워드 갭 분석
- 에이전트 C: 포맷 갭 분석
- 에이전트 D: 시청자 갭 분석 (댓글 마이닝)
다른 모든 하위 스킬은 인라인(단일 스레드)으로 실행됩니다. 에이전트 도구를 사용할 수 없는 경우 순차적 인라인 실행으로 대체하십시오.
기타 플랫폼 (Codex, Gemini CLI, ChatGPT, Gemini): 여기서 도구 이름은 Claude Code의 것입니다. 플랫폼에 해당하는 도구(하위 에이전트, 웹 검색)를 사용하거나 인라인으로 실행하십시오. execution/ 스크립트를 실행할 수 없는 경우(ChatGPT/Gemini 앱), 사용자에게 채널 통계, 비디오 목록 또는 분석 내보내기를 붙여넣도록 요청하십시오. /youtube <command>는 일반 텍스트로도 입력할 수 있습니다(예: "youtube audit @channel").
참조 파일
하위 스킬이 요청할 때 필요에 따라 로드하십시오. 한 번에 모두 미리 로드하지 마십시오. 이 세션에서 이미 컨텍스트에 있는 참조 파일을 다시 로드하지 마십시오.
| 파일 | 내용 |
|---|---|
references/algorithm-guide.md | 3-시스템 아키텍처, 테스팅 캐스케이드, CTR/AVD 벤치마크, 2024-2025 변경사항 |
references/seo-playbook.md | 제목/설명/태그/챕터/해시태그 규칙, VideoObject 스키마 |
references/retention-scripting-guide.md | 후크 프레임워크, 패턴 인터럽트, CTA 배치, 리텐션 그래프 |
references/thumbnail-ctr-guide.md | 틈새별 CTR, 얼굴 심리학, A/B 테스팅, 제목 공식 |
references/shorts-playbook.md | 쇼츠 알고리즘, 포맷 사양, 수익화, 재활용 |
references/analytics-guide.md | 메트릭 계층, 퍼널 비율, 틈새별 RPM/CPM |
references/monetization-guide.md | YPP 티어, 7가지 수익원, 브랜드 딜 요금 |
references/repurposing-guide.md | Hub/Hero/Help 모델, 크로스 플랫폼 워크플로우, 플랫폼 사양 |
references/dataforseo-integration.md | DataForSEO MCP 도구 참조, YouTube SERP, 키워드 연구, 트렌드 |
DataForSEO MCP 통합 (선택 사항)
DataForSEO MCP 서버를 사용할 수 있는 경우(에이전트의 MCP 설정에 구성됨), YouTube 스킬은 키워드 연구, YouTube SERP 분석, 트렌드 인텔리전스, 비디오 메타데이터 및 경쟁 조사에 실시간 데이터를 사용합니다. 사용할 수 없으면 WebSearch + 실행 스크립트로 대체합니다.
참조: 전체 도구 참조, 매개변수 및 효율성 지침은 references/dataforseo-integration.md를 로드하십시오.
감지: DataForSEO 도구 호출(예: serp_youtube_organic_live_advanced)을 시도하십시오. 실패하면 WebSearch + 실행 스크립트로 대체하십시오. DataForSEO를 사용할 수 없다고 워크플로우를 차단하지 마십시오.
기본 매개변수: location_code=2840 (US), language_code="en"
주요 YouTube DataForSEO 도구
| 도구 | 목적 |
|---|---|
serp_youtube_organic_live_advanced | 키워드에 대한 YouTube 검색 결과 — 조회수가 포함된 비디오, 채널, 재생목록 |
serp_youtube_video_info_live_advanced | 심층 비디오 분석 — 조회수, 좋아요, 댓글, 태그, 카테고리, 자막 |
serp_youtube_video_comments_live_advanced | 참여 데이터가 포함된 비디오 댓글 |
serp_youtube_video_subtitles_live_advanced | 비디오 대본/자막 추출 |
kw_data_google_ads_search_volume | 키워드 배열에 대한 검색량, CPC, 경쟁 |
dataforseo_labs_google_keyword_ideas | 시드 키워드에서 키워드 아이디어 |
dataforseo_labs_google_keyword_suggestions | 자동 완성 스타일 키워드 제안 |
dataforseo_labs_bulk_keyword_difficulty | 키워드 난이도 점수 (0-100) |
dataforseo_labs_search_intent | 의도 분류 (정보/상업/거래) |
kw_data_google_trends_explore | Google 트렌드 시계열 (YouTube별 필터링 지원) |
하위 스킬 → DataForSEO 모듈 매핑
| 하위 스킬 | 사용되는 DataForSEO 도구 |
|---|---|
| ideate | YouTube SERP + 키워드 아이디어 + 트렌드 + 볼륨 |
| seo | 볼륨 + 난이도 + 의도 + YouTube SERP 경쟁 |
| competitor | YouTube SERP × 키워드 + 비디오 정보 + 댓글 |
| strategy | 트렌드 + 볼륨 + YouTube SERP + 키워드 아이디어 |
| calendar | 계획을 위한 Google 트렌드 + 우선순위를 위한 볼륨 |
| analyze | YouTube SERP 위치 추적 + 비디오 정보 |
| audit | YouTube SERP + 볼륨 + 비디오 정보 + 키워드 난이도 |
| shorts | YouTube SERP (쇼츠 필터) + 트렌드 |
| hook | 키워드에 대한 YouTube SERP 상위 비디오 제목 |
| thumbnail | YouTube SERP 경쟁자 썸네일 |
| metadata | 태그 최적화를 위한 볼륨 + 난이도 |
API 크레딧 인식
DataForSEO는 API 호출당 요금을 부과합니다. 일반 워크플로우 비용은 $0.002-$0.04입니다. 규칙:
- 키워드를 단일 호출로 배치 (볼륨, 난이도, 의도 도구는 배열 허용)
- 동일 세션에서 이미 검색된 데이터를 다시 가져오지 마십시오
- 단일 키워드 조회에는
dataforseo_labs_google_keyword_overview를 사용하십시오 - 비용이 많이 드는 작업을 실행하기 전에 사용자에게 경고하십시오
NanoBanana MCP — 썸네일 생성 (선택 사항)
NanoBanana MCP 서버가 구성된 경우 thumbnail 하위 스킬은 텍스트 브리프만 생성하는 대신 Gemini 모델을 사용하여 실제 썸네일 이미지를 생성할 수 있습니다.
도구: generate_image
권장 썸네일 설정:
aspect_ratio:"16:9"(YouTube 표준)resolution:"4k"(YouTube 최소 1280×720)model_tier:"nb2"(빠르고 고품질의 프로덕션 자산)
감지: generate_image 도구 호출을 시도하십시오. 사용할 수 없는 경우 텍스트 기반 썸네일 브리프만 제공하십시오 — 디자이너가 실행하기에 충분히 상세합니다.
워크플로우: 기본 썸네일 + 3개의 A/B 변형 = 브리프당 generate_image 호출 4회. 프롬프트 엔지니어링 지침은 sub-skills/thumbnail.md를 참조하십시오.
실행 스크립트
스크립트에는 YouTube API 자격 증명이 필요합니다. 스크립트를 호출하기 전에:
YOUTUBE_API_KEY환경 변수가 존재하는지 확인하십시오- 누락된 경우, 자동으로 실패하지 말고 사용자에게 설정 지침을 제공하십시오
- Analytics API 스크립트의 경우 OAuth 토큰이 있는지 확인하십시오
자격 증명이 없으면 사용자에게 데이터를 수동으로 제공하도록 요청하는 것으로 대체하십시오(예: YouTube Studio 스크린샷 붙여넣기 또는 메트릭 설명).
| 스크립트 | 목적 | 할당량 비용 |
|---|---|---|
execution/fetch_channel_data.py | Data API v3를 통한 채널 통계 + 최근 N개 비디오 | ~16 units |
execution/fetch_video_analytics.py | 비공개 분석 (자체 채널, OAuth) | ~5 units |
execution/search_competitor_videos.py | 경쟁자 비디오 검색 (비용 높음) | 100 units/검색 |
execution/fetch_transcript.py | 비디오 대본 추출 | 1-2 units |
execution/utils/quota_tracker.py | 10K unit/일 할당량 추적 | 0 units |
execution/utils/youtube_auth.py | API 키 + OAuth 핸들러 | 0 units |
품질 게이트
모든 하위 스킬 출력은 전달 전에 다음 검사를 통과해야 합니다:
- 구체성 — 모든 권장 사항은 이 채널에 대해 실행 가능해야 합니다. "일관되게 게시"와 같은 일반적인 조언 없이 그들의 티어에 맞는 주기를 지정하십시오.
- 데이터 근거 — 인용된 모든 벤치마크는 참조 파일에서 가져와야 합니다. 통계를 절대 환각하지 마십시오. 확실하지 않으면 "벤치마크를 사용할 수 없음"이라고 말하고 설명하십시오.
- 완전성 — 하위 스킬 출력 템플릿의 모든 섹션이 있어야 합니다. 섹션 누락 = 불완전한 결과물.
자체 어닐링 루프
하위 스킬 출력이 품질 게이트에 실패하면:
- 어떤 게이트가 왜 실패했는지 식별하십시오
- 누락된 데이터를 위해 관련 참조 파일을 다시 읽으십시오
- 실패한 섹션만 다시 생성하십시오
- 세 가지 게이트를 다시 확인하십시오
- 2회 시도 후에도 실패하면, 명시적 주의 사항과 함께 제한 사항을 명시하여 전달하십시오
출력 형식
기본값은 마크다운입니다. metadata 하위 스킬의 경우 복사하여 붙여넣기 가능한 일반 텍스트 블록을 생성하십시오. calendar의 경우 마크다운 테이블을 생성하십시오. audit의 경우 점수가 포함된 구조화된 보고서를 생성하십시오. 항상 논리적인 다음 단계를 가리키는 "다음 단계" 섹션으로 끝내십시오(예: audit 이후 → strategy 또는 가장 낮은 점수 차원의 하위 스킬 제안).