Communitygithub.com

nategoldai/youtube-agent

YouTube 동영상의 설명, 챕터, 태그 및 검색 노출 텍스트를 실제 사람이 입력할 법한 내용으로 작성합니다. '설명 작성', '챕터 추가', '타임스탬프', '태그', 'SEO', '이 동영상이 검색되게 해줘' 또는 '아무도 이 동영상을 못 찾아요' 같은 경우에 사용하세요.

youtube-agent란 무엇인가요?

이 스킬은 YouTube 동영상의 SEO(검색 엔진 최적화)를 돕기 위해 설계된 AI 에이전트 도구입니다. 사용자가 동영상의 설명, 챕터, 태그를 작성할 때 실제 사람이 검색할 법한 키워드와 자연스러운 표현을 기반으로 생성합니다. 주요 기능으로는 타임스탬프가 포함된 자막 파일을 분석하여 챕터를 자동으로 분할하는 `chapters.py` 스크립트, 사용자의 음성 프로필을 참조하여 일관된 톤을 유지하는 기능, 그리고 검색 테스트를 통해 제목과 설명 상단에 핵심 검색어가 포함되도록 검증합니다. 이 스킬은 Claude Code, Cursor, Codex 등과 같은 AI 코딩 에이전트에서 사용할 수 있으며, 사용자 정의 설정 파일(`~/.claude/youtube/voice.md`)을 통해 개인의 말투를 학습합니다. 최종 결과물은 복사 가능한 블록 형태로 제공되며, 사용자가 직접 게시 여부를 결정합니다.

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

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

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

문서

yt-seo

검색은 포장(packaging)보다는 덜 중요하지만, 상시 업로드(evergreen) 동영상의 경우 사람들이 생각하는 것보다 더 중요합니다. 동영상이 구독자 피드에 맞춰진 것이라면 그렇게 말하고, 대신 /yt-package에 집중하세요.

python3 chapters.py transcript.srt --target 8

작성 전

  1. ~/.claude/youtube/voice.md 파일이 있으면 읽으세요. 이 파일은 사용자의 음성 프로필입니다: 카메라 앞에서 말하는 방식, 절대 사용하지 않는 단어, 대상 청중, 그리고 주장하지 않는 내용을 담고 있습니다. 파일이 없으면 사용자의 동영상 세 개를 요청하고, 이를 읽거나 자막을 받아 음성을 파악한 후 파일을 작성하세요.
  2. 숫자, 결과 또는 출처를 절대 지어내지 마세요. 수치가 도움이 되지만 없는 경우, 이를 요청하거나 해당 수치 없이 문장을 작성하세요.

설명

  • 처음 두 줄만 읽힙니다. 이 두 줄은 "...더보기" 위에 표시되고 검색 스니펫으로 사용됩니다. 사람들이 검색했을 법한 단어로 동영상이 제공하는 내용을 말하세요.
  • 다음으로, 링크나 리소스가 있다면 접힌 부분 위에 오도록 배치하세요.
  • 그다음 챕터(아래 참조)를 작성하세요.
  • 마지막으로 긴 버전: 다루는 내용, 대상 청중, 그리고 이미 알고 있다고 가정하는 내용을 작성하세요.

챕터

chapters.py는 타임스탬프가 포함된 자막에서 구분점을 찾습니다. YouTube의 규칙을 위반하는 챕터 목록은 조용히 실패하며, 블록은 설명에서 아무 역할도 하지 않습니다:

  • 첫 번째 챕터는 00:00이어야 합니다.
  • 최소 세 개 이상이어야 합니다.
  • 각 챕터는 최소 10초 길이여야 합니다.

이 도구는 세 가지 규칙을 모두 확인하고, 목록이 작동하지 않을 때 사용자에게 알려줍니다.

이 도구는 실제로 사용한 일시 정지를 어휘 변화 정도에 따라 점수를 매겨 BREAKS(구분점)를 잘 찾아냅니다. 제공되는 제목은 단지 주제 단어일 뿐이므로 초안으로 취급하세요. "Thumbnails Titles Packaging" 같은 챕터는 임시 자리 표시자입니다. 각 챕터를 사용자의 음성으로, 세에서 다섯 단어로 해당 섹션의 약속으로 다시 작성하세요.

챕터는 또한 유지율 확인 역할을 합니다: 섹션을 다섯 단어로 이름을 지을 수 없다면, 두 개의 섹션이거나 내용이 부실한 것입니다.

태그, 솔직히

태그는 약한 신호이며, YouTube도 그렇게 밝혔습니다. 모호함을 해소하는 데 사용하세요: 다른 철자, 도구 이름, 사람들이 실제로 입력하는 약어. 그런 다음 멈추세요. 15개면 충분합니다. 태그를 잔뜩 쌓는 것은 전략이 아니며, 관련 없는 태그를 넣는 것은 규칙을 위반합니다.

검색 테스트

무언가를 넘기기 전에, 이 동영상이 승리해야 할 세 가지 검색어를 적고, 제목과 설명의 처음 두 줄에 해당 검색어의 단어가 포함되어 있는지 확인하세요. 포함되어 있지 않다면, 문제는 설명이 아니라 제목입니다.

게이트

여기서 작성된 내용은 절대 게시되지 않습니다. 이 스킬은 작성만 하고, 사용자가 게시합니다. 모든 결과는 사용자가 복사할 수 있는 블록으로 끝나며, 매 실행 마지막 줄은 다음과 같이 묻습니다: 게시할까요, 아니면 수정할까요?

Individual skills in this repo

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

nategoldai/youtube-agent

>- Review a YouTube channel from top to bottom - packaging, consistency, the first fifteen seconds, and what to fix first. Use for "audit my channel", "why isn't my channel growing", "look at my videos", or a pasted channel URL.

nategoldai/youtube-agent

>- Write replies to YouTube comments in the creator's voice, sorted by which ones are worth answering. Use for "reply to my comments", "deal with the comment section", "someone asked X", or a pasted comment thread.

nategoldai/youtube-agent

>- Turn the transcript of a raw recording into an edit decision list - dead air, filler lines and retakes, with timecodes. Use for "edit this", "cut the dead space", "tighten this video", "I rambled", or any request to shorten footage from a transcript.

nategoldai/youtube-agent

>- Write and check a YouTube video's title and thumbnail as one pair, testing for truncation, repetition and vagueness before it goes live. Use for "title ideas", "what should I call this", "thumbnail text", "my CTR is low", packaging, or any request to rename or repackage an existing video.

nategoldai/youtube-agent

>- Plan a week or a month of YouTube uploads - what to post, when, and in what order, sized to how much time the creator really has. Use for "plan my week", "content calendar", "what should I post", "no idea what to make next".

nategoldai/youtube-agent

>- Read a YouTube Studio audience-retention export, find where viewers really drop off, and say what to change. Use for "why do people stop watching", "my retention is bad", a pasted retention chart or CSV, or "fix my pacing".

nategoldai/youtube-agent

>- Write a YouTube video script from a rough idea - hook options from 21 formulas, scored, then the full spoken script with the retention beats marked. Use whenever the user wants a video script, a hook, an opening line, "what should I say", "write my next video", or is about to record without the first fifteen seconds figured out.

nategoldai/youtube-agent

>- Find the Shorts hiding inside a long video and write them, using the transcript to pick moments that stand on their own. Use for "cut this into shorts", "clip this", "repurpose this video", or "what should I clip".

nategoldai/youtube-agent

>- Find what's really working in the user's niche on YouTube, rank it by how far each video beat its own channel, then name the formula. Use for "what's working right now", "find viral videos in my niche", "why did this blow up", competitor research, or a swipe file.

관련 스킬