YouTube 챕터 (yt-chapters)
python3 ${CLAUDE_SKILL_DIR}/chapters.py transcript.srt --target 8
도구들은 이 스킬의 폴더에 있습니다. ${CLAUDE_SKILL_DIR}은 Claude Code에서 해당 폴더를 의미합니다. (claude.ai나 Codex처럼 확장되지 않는 환경에서는 이 SKILL.md가 로드된 폴더를 사용하세요.)
트랜스크립트를 읽기 위해 ../yt-edit/deadair.py를 함께 사용하므로, 두 스킬을 함께 설치하세요.
링크는 있지만 트랜스크립트가 없다면? YouTube 자체 자막을 한 줄로 가져올 수 있습니다:
yt-dlp --skip-download --write-auto-subs --sub-langs en --sub-format vtt -o transcript "<video url>"
위 명령은 transcript.en.vtt 파일을 생성합니다. en을 비디오 언어에 맞게 바꾸세요. 자동 자막에는 구두점이 없지만, whisper 트랜스크립트는 구두점이 있어 더 깔끔한 문장 경계를 제공합니다.
작성 전 확인 사항
~/.claude/youtube/voice.md 파일이 존재하면 읽어보세요 — 작성하는 제목은 사용자의 말투를 따라야 하며, 여러분의 말투가 아니어야 합니다. 파일이 없다면 평이하게 제목을 다시 쓰고, 음성 파일이 있으면 더 정확해질 수 있다고 알려주세요.
반드시 지켜야 할 규칙 (선택 사항이 아님)
다음 규칙 중 하나라도 위반하는 챕터 목록은 챕터로 렌더링되지 않고 설명에 그대로 남아 아무 일도 하지 않습니다:
- 첫 번째 항목은 00:00이어야 합니다.
- 최소 3개 이상이어야 합니다.
- 각 챕터는 최소 10초 이상이어야 합니다.
- 오름차순으로 정렬되어야 합니다.
일부 채널은 스튜디오에서 고급 기능을 활성화해야 챕터가 표시됩니다. 유효한 목록이 렌더링되지 않는다면, 가장 먼저 이 부분을 확인하세요.
도구는 위 규칙을 모두 검사하여 붙여넣기 전에 목록이 유효하지 않음을 알려줍니다.
모든 줄을 다시 제목으로 작성하세요
chapters.py는 경계를 잘 찾아냅니다 — 실제로 쉰 구간에서 어휘 변화 정도를 점수화합니다. 하지만 생성된 제목은 주제 단어로 구성된 초안일 뿐입니다. "Thumbnails Titles Packaging" 같은 챕터 제목은 임시 자리 표시자입니다. 각 제목을 사용자의 말투로 3~5단어 내에서 해당 섹션의 약속으로 다시 작성하세요.
챕터는 유지율 진단 도구이기도 합니다: 섹션을 5단어로 명명할 수 없다면, 그 섹션은 두 개로 나누거나 불필요한 내용입니다.
게이트 (게시 전 단계)
여기서 아무것도 게시되지 않습니다. 이 스킬은 작성만 하고, 여러분이 게시합니다. 모든 출력은 사용자가 복사할 수 있는 블록으로 끝나며, 실행의 마지막 줄은 질문입니다: 보낼까요, 아니면 바꿀까요?