Jakeschincariol/youtube-agent-skill

YouTube 에이전트 스킬 – 빠른 개요

설명: YouTube 영상의 기획, 집필, 편집, 최적화를 돕는 11개의 Claude '스킬' 모음입니다. 이 도구들은 로컬 Python 3 환경에서 실행되며(추가 패키지 불필요), /yt‑script 또는 /yt‑viral과 같은 명령어를 통해 Claude에서 호출됩니다. 이 도구들은 자동으로 게시하지 않으며, 사용자가 YouTube에 복사하여 붙여넣을 텍스트, 점수 또는 결정 목록만 생성합니다.

주요 기능

스킬	주요 기능
/yt‑script	아이디어 하나로 영상 대본을 생성하고, 21가지 사전 정의된 공식을 사용하여 5개의 후크 라인을 제안하며, 각 후크의 점수를 매기고 시청 유지율을 높일 지점을 표시합니다.
/yt‑package	제목과 썸네일 쌍의 길이, 중복성, 모호성을 검사하여 최적화된 패키지를 반환합니다.
/yt‑edit	자막 파일(.srt)을 편집 결정 목록(무음 구간, 불필요한 말, 재촬영 구간)과 타임스탬프로 변환합니다.
/yt‑comment	댓글 섹션을 분석하여 4가지 범주로 분류하고, 사용자의 말투로 답글 초안을 작성하며, 고정할 댓글을 추천합니다.
/yt‑plan	사용 가능한 시간에 맞춰 주간 제작 일정(메인 영상 1개, 저비용 영상 1개, Shorts 3개)을 생성합니다.
/yt‑viral	틈새 시장의 공개 영상을 분석하여 채널 중앙값 대비 성과가 높은 순으로 순위를 매기고, 바이럴을 유도하는 패턴을 찾아냅니다.
/yt‑retention	YouTube 시청 유지율 CSV를 분석하여 시청자가 이탈하는 정확한 초를 찾아내고 해당 시점의 대사 내용을 보여줍니다.
/yt‑shorts	긴 영상 속에 숨겨진 숏폼 클립을 감지하고 각 Shorts 버전에 맞는 새로운 오프닝 라인을 작성합니다.
/yt‑seo	영상 설명, 유용한 태그, 3개의 타겟 검색 쿼리를 생성합니다.
/yt‑chapters	자막에서 YouTube 호환 챕터 타임스탬프를 생성하고 YouTube 형식 규칙을 준수하는지 검증합니다.
/yt‑audit	채널 전체를 고수준으로 감사하고 가장 영향력 있는 개선 사항 하나를 출력합니다.

6개의 기반 Python 도구(명령줄에서 직접 실행)가 위 스킬들의 핵심 처리를 담당합니다:

• hookscore.py – 5가지 지표를 통한 후크 품질 평가 패널.
• title.py – 제목 및 썸네일 린터.
• deadair.py – 편집 결정 목록 생성기.
• chapters.py – 챕터 검증기.
• retention.py – 시청 유지율 분석기.
• swipe.py – 틈새 시장 바이럴 트렌드 감지기.

모든 도구는 의존성이 없으며 깨끗한 Python 3 환경에서 작동합니다.

설치

1. 리포지토리를 클론합니다.
2. yt‑* 스킬 폴더를 ~/.claude/skills/(또는 리포지토리의 .claude/skills/)에 복사합니다.
3. 선택적으로 /plugin marketplace add …를 사용하여 리포지토리를 Claude 플러그인으로 추가합니다.
4. ~/.claude/youtube/voice.md를 설정(또는 SKILL.md를 채팅에 붙여넣기)하여 Claude에게 사용자의 말투를 학습시킵니다.

제한 사항 및 주의 사항

• 자동 게시 기능은 없습니다. 생성된 에셋은 수동으로 업로드해야 합니다.
• 후크 점수는 휴리스틱 기반이며 예측 모델이 아닙니다. 높은 점수가 성과를 보장하지는 않습니다.
• /yt‑viral은 공개 데이터만 읽으며 계정에 로그인하지 않습니다.
• 태그 제안은 태그가 성과에 미치는 영향이 제한적이므로 최소화되어 있습니다.

라이선스: MIT – 자유롭게 사용, 수정 및 재배포 가능.

---

누가 사용하면 좋을까요?

• 외부 API나 유료 서비스에 의존하지 않고 AI의 도움을 받고 싶은 중소규모 YouTube 크리에이터.
• 이미 Claude를 사용 중이며 개인정보 보호가 가능한 로컬 워크플로우를 선호하는 팀.
• Python 스크립트를 Claude '스킬'로 변환하는 구체적인 예시를 찾는 개발자.

---

결론: 이 리포지토리는 Claude AI 어시스턴트에 YouTube 콘텐츠 제작을 위한 실용적인 스크립트 기반 유틸리티를 추가하는 본격적인 오픈 소스 툴킷입니다. AI 보조 워크플로우 자동화의 범위를 유지하면서 모든 것을 로컬에서 실행할 수 있도록 합니다.