클로드 기반 유튜브 채널 자동화 도구 세트 'youtube-agent-skill'
대본 작성, 제목·썸네일 검증, 무음 편집 지시서 생성, 시청 지속률 분석 등 11개 Claude 스킬과 의존성 없는 6종 Python 스크립트로 구성된 MIT 라이선스 오픈소스 저장소입니다.
Jakeschincariol/youtube-agent-skill은 유튜브 채널 기획부터 대본 작성, 편집 정리, 성과 분석까지 11개 작업 단위로 나눈 오픈소스 Claude 스킬 모음입니다. 무료 MIT 라이선스로 배포되며 회원가입이나 별도 API 키 연동 없이 바로 사용할 수 있습니다. 공식 GitHub 저장소는 2026년 9월 16일 생성되었고, 최근 저장소 갱신일인 2026년 11월 13일 기준 별(Star) 5,797개와 포크(Fork) 1,663개를 기록했습니다.

이미지 출처: https://x.com/dopamine_crypto/status/2118644566987526434
기존 AI 기반 영상 제작 도구들이 프롬프트 한 줄로 결과물을 생성하는 데 그쳤다면, 이 저장소는 프롬프트 지시서(SKILL.md)와 외부 라이브러리 설치가 필요 없는 순수 Python 3 로컬 스크립트 6종을 결합했습니다. 대본의 첫 문장(훅) 점수를 계산하거나 자막 파일에서 무음 구간을 찾아내는 정량 계산은 파이썬 도구가 맡고, 문맥에 맞는 대본 집필과 댓글 초안 작성은 Claude가 담당하는 구조입니다.
기획부터 분석까지 11개 Claude 스킬과 6종 Python 스크립트 구성
저장소는 유튜브 채널 운영 과정을 11개 슬래시 명령어(skills/yt-*)로 세분화했습니다. 각 스킬은 단독 프롬프트가 아니라, 필요한 경우 로컬 Python 3 스크립트를 호출해 데이터를 검증한 뒤 결과를 제안합니다.
- 기획 및 대본 작성 (
/yt-plan,/yt-script):/yt-plan은 가용 시간에 맞춰 주간 편성표(메인 영상 1편, 저비용 영상 1편, 쇼츠 3편)를 짭니다./yt-script는 21가지 훅 공식(hooks.json)을 바탕으로 도입부 후보 5개를 생성한 뒤hookscore.py로 5가지 항목의 강도를 채점하고, 시청 이탈 방어 지점(retention beats)을 표시한 구어체 대본을 작성합니다. - 패키징 및 검색 최적화 (
/yt-package,/yt-seo,/yt-chapters):/yt-package는 제목과 썸네일 문구를 하나의 세트로 묶어title.py로 검사합니다. 두 요소가 같은 말을 중복하거나 모바일 화면에서 잘리는 현상, 모호한 표현을 걸러냅니다./yt-seo는 영상 설명글과 핵심 검색어 3개를 도출하며,/yt-chapters는 자막 파일(transcript.srt)을 분석해chapters.py로 유튜브 렌더링 규칙에 맞는 타임스탬프 챕터를 생성합니다. - 편집 정리 및 쇼츠 추출 (
/yt-edit,/yt-shorts): 촬영 후 추출한 자막 파일을/yt-edit에 입력하면deadair.py가 무음 구간(dead air), 군더더기 추임새, 재촬영 구간을 시간 코드와 함께 정리한 편집 지시서(EDL)를 만듭니다./yt-shorts는 긴 영상 속에서 쇼츠로 잘라낼 만한 구간을 찾고 쇼츠 전용 첫 문장을 새로 씁니다. - 성과 분석 및 채널 운영 (
/yt-retention,/yt-viral,/yt-audit,/yt-comment):/yt-retention은 유튜브 스튜디오에서 내보낸 시청 지속률 데이터(retention.csv)를retention.py로 읽어 시청자가 급격히 이탈한 정확한 초와 당시 발화 내용을 찾아냅니다./yt-viral은swipe.py를 통해 니치 시장의 공개 영상 목록을 수집한 뒤, 구독자 규모가 아닌 해당 채널 자체의 평균 조회수 대비 배수(--min 2.0등)로 흥행 사례를 정렬합니다./yt-audit은 채널 전체를 점검해 수정할 최우선 과제 1가지를 제시하며,/yt-comment는 댓글을 4가지 유형으로 분류해 답변 초안과 고정 추천 댓글을 고릅니다.
설치 방법과 채널 톤앤매너(voice.md) 설정
이 도구는 Claude Code 터미널 환경에서 플러그인으로 설치하거나 스킬 디렉터리에 직접 복사해 사용할 수 있습니다. 별도의 pip install 과정 없이 표준 Python 3 환경만 있으면 6개 스크립트가 모두 동작합니다.
- Claude Code 플러그인 설치: 터미널이나 Claude Code 프롬프트에서
/plugin marketplace add Jakeschincariol/youtube-agent-skill명령어를 입력한 뒤/plugin install youtube-agent를 실행합니다. - 수동 디렉터리 복사: 저장소를 복제(
git clone https://github.com/Jakeschincariol/youtube-agent-skill.git)한 뒤skills/yt-*폴더 전체를 전역 경로(~/.claude/skills/) 또는 개별 프로젝트 경로(.claude/skills/)로 복사합니다. - 채널 목소리 템플릿 작성: 설치 후에는 저장소 내
templates/voice.md파일을~/.claude/youtube/voice.md경로로 복사해 채워 넣어야 합니다. 11개 스킬 전체가 이 파일을 참조해 채널 고유의 말투와 어조를 유지합니다. 직접 작성하기 어렵다면 기존에 제작한 영상 3편의 대본이나 자막을 Claude에게 전달하며voice.md작성을 요청할 수 있습니다.
사용 전 확인할 한계와 주의사항
저장소 문서(README)는 이 도구가 자동화하지 않는 영역과 분석 도구의 한계를 명확히 안내하고 있습니다.
- 자동 업로드 미지원: 유튜브 데이터 API(YouTube Data API) 연동이나 OAuth 로그인 기능이 포함되어 있지 않습니다. 모든 스킬은 복사해서 쓸 수 있는 텍스트 블록을 출력하며, 실제 영상 촬영과 편집, 최종 업로드는 사용자가 직접 수행해야 합니다.
- 휴리스틱 채점의 한계: 대본 도입부를 평가하는
hookscore.py는 5개 채널의 숏폼 영상 74개(상위 8개·하위 8개 조회수 그룹의 초반 15초 자막)를 기준으로 보정한 휴리스틱(경험적 규칙) 검증기입니다. 의도적으로 부실한 훅을 걸러내는 데는 유효하지만, 특정 크리에이터의 대박 영상과 평작을 정밀하게 예측하거나 조회수를 보장하지는 않습니다. - 웹 채팅 단독 실행 시 기능 축소: Claude Code가 아닌 일반 Claude 웹 채팅창에 개별
SKILL.md내용을 붙여넣어 모드로 실행할 수는 있습니다. 다만 이 경우 로컬 환경에서 실행되는 Python 3 스크립트 6종 연동이 제외되므로/yt-script,/yt-retention,/yt-edit등의 정량 분석 기능은 작동하지 않습니다. - 공개 데이터 기반 조회:
/yt-viral도구는 공개된 채널 목록 데이터만 읽으며 사용자 계정으로 로그인하거나 인증 정보를 요구하지 않습니다.
출처
- GitHub 공식 저장소: Jakeschincariol/youtube-agent-skill
- X 원문 게시글 (@dopamine_crypto): 2026-11-06 youtube-agent-skill 소개 스레드