Communitygithub.com

utillayer/youtube-agent-skill

YouTube 제목과 썸네일을 하나의 단위로 작성하고 린트하여, 게시 전에 잘림, 중복, 모호함을 확인합니다. '제목 아이디어', '이 영상 제목 뭐로 할까', '썸네일 텍스트', 'CTR이 낮아요', 패키징, 또는 기존 영상의 이름/패키지를 변경하는 요청에 사용하세요.

youtube-agent-skill란 무엇인가요?

이 스킬은 YouTube 콘텐츠 제작자가 제목과 썸네일을 분리된 요소가 아닌 하나의 통합 단위로 작성하도록 돕습니다. 주요 기능은 제목과 썸네일 텍스트의 중복을 방지하고, 다양한 기기(데스크탑, 모바일)에서의 텍스트 잘림 문제를 사전에 점검하며, 모호하거나 CTR에 부정적인 영향을 줄 수 있는 표현을 걸러내는 린터(linter)입니다. Claude Code 환경에서 `title.py` 스크립트를 통해 작동하며, 사용자의 음성 프로필(voice profile)을 자동으로 읽거나 생성하여 일관된 톤을 유지하도록 돕습니다. 10개의 후보 제목을 생성하고 상위 3개를 점수와 함께 제시한 후, 최종 선택된 항목에 대한 썸네일 브리프까지 제공합니다. 또한 YouTube Studio의 A/B 테스트 기능을 연계하여 데이터 기반 의사 결정을 지원하며, 절대 게시(publish)는 수행하지 않고 사용자가 직접 확인 후 결정하도록 설계되었습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utillayer/youtube-agent-skill/tree/HEAD/skills/yt-package

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

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

문서

yt-package

제목과 썸네일은 하나의 단위입니다. 이 둘을 분리해서 작성하는 것이 대부분의 패키징이 실패하는 이유입니다. 썸네일이 제목을 반복하게 되고, 클릭할 수 있는 표면의 절반이 같은 내용을 두 번 말하게 됩니다.

python3 ${CLAUDE_SKILL_DIR}/title.py --title "..." --thumb "AI RAN IT"
python3 ${CLAUDE_SKILL_DIR}/title.py titles.txt --thumb "AI RAN IT"   # 한 줄에 하나씩, 순위별로 정렬

도구들은 이 스킬의 폴더 안에 있습니다. ${CLAUDE_SKILL_DIR}은 Claude Code에서 해당 폴더를 가리킵니다. 이 값이 확장되지 않는 환경(claude.ai, Codex)에서는 이 SKILL.md가 로드된 폴더를 사용하세요.

작성 전 확인 사항

  1. ~/.claude/youtube/voice.md 파일이 있으면 읽으세요. 이 파일은 사용자의 음성 프로필(voice profile)입니다. 즉, 카메라 앞에서 사용자의 말투, 절대 사용하지 않는 단어, 대화 상대, 주장하지 않을 내용이 기록되어 있습니다. 파일이 없으면 사용자의 영상 세 개를 요청하고, 이를 읽거나 받아쓰기(transcribe)하여 음성을 추론한 후 파일을 작성하세요. 잘못된 음성으로 작성된 스크립트는 스크립트가 없는 것보다 나쁩니다. 사용자가 직접 소리 내어 읽어야 하기 때문입니다.
  2. 숫자, 결과, 출처를 절대 지어내지 마세요. 어떤 수치가 주장을 강하게 만들지만 당신이 가지고 있지 않다면, 사용자에게 요청하거나 해당 줄을 빼고 작성하세요.

도구가 강제하는 규칙과 그 이유

  • 약 60자는 데스크탑 검색에서 살아남고, 약 40자는 모바일 홈 피드에서 살아남습니다. YouTube는 두 숫자 모두 공개하지 않습니다. 잘림(truncation)은 픽셀 너비에 따라 결정되며 표면(surface)에 따라 다릅니다. 따라서 이 숫자들을 절대적인 규칙이 아닌, 안전한 경계선으로 취급하세요. 두 숫자가 모두 보고되는 이유는 서로 다른 방식으로 실패하기 때문입니다. 데스크탑에서 잘리면 꼬리가 사라지고, 모바일에서 잘리면 주제가 사라질 수 있습니다. 100자는 하드 리미트이며, <와 >는 허용되지 않습니다.
  • 썸네일은 제목을 반복해서는 안 됩니다. 다른 단어, 같은 약속.
  • 썸네일에는 최대 세 단어까지만 사용하세요. 피드 크기에서 네 번째 단어는 회색 얼룩처럼 보입니다.
  • 숫자, 이름, 날짜는 당신이 사용할 수 있는 모든 형용사보다 낫습니다.
  • 두 개의 대문자 단어가 넘어가면 제목이 스팸으로 읽힙니다.

열 개 작성, 두 개 유지

열 개의 제목을 생성하고, 모두 title.py로 실행한 후, 상위 세 개의 점수와 각각의 구체적인 문제점을 사용자에게 보여주세요. 승자에 대해서는 썸네일 브리프를 작성하세요: 표정, 프레이밍, 세 단어, 그리고 피드 크기에서 대비를 유지하기 위해 배경이 해야 할 일.

그다음은 YouTube에게 맡기세요

YouTube Studio는 최대 세 개의 제목, 세 개의 썸네일, 또는 둘 다를 A/B 테스트할 수 있으며, 시청 시간 점유율(watch time share)을 기준으로 선택합니다. 이 기능은 데스크탑 Studio에서 실행되며, 고급 기능이 켜져 있어야 하고, 최대 2주가 소요되며, Shorts에서는 작동하지 않습니다. 상위 두 개가 비슷하다면, 그 사실을 말하고 린터가 둘을 구분할 수 있는 척하지 말고 두 개를 모두 테스트에 넘기세요. 점수는 린트(lint)일 뿐, 예측이 아닙니다.

게이트

여기서 아무것도 게시(publish)되지 않습니다. 이 스킬은 작성(write)하고 당신이 게시(publish)합니다. 모든 출력은 사용자가 복사하는 블록으로 끝나며, 모든 실행의 마지막 줄은 질문입니다: 배포할까요, 아니면 수정할까요?

Individual skills in this repo

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

관련 스킬