Youtube transcript

Skill ComeOnOliver/skillshub/skills/aiskillstore/marketplace/doyajin174/youtube-transcript

🧠 The right skill, one API call. AI agent skills registry with token-efficient skill resolution. 5,000+ skills from 500+ top repos.

Install

npx -y skills add ComeOnOliver/skillshub --skill youtube-transcript

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Download and process YouTube video transcripts using yt-dlp. Use this when extracting subtitles, creating summaries from videos, or processing video content.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.9 KB, as published. Nobody here has run it

YouTube Transcript Downloader

유튜브 영상에서 자막을 추출하고 처리하는 스킬입니다.

Priority Order

1. yt-dlp 설치 확인
2. 사용 가능한 자막 목록 확인
3. 수동 자막 우선 시도
4. 자동 생성 자막 폴백
5. 최후 수단: Whisper 변환

Requirements

# macOS
brew install yt-dlp

# Linux
sudo apt install yt-dlp

# Universal
pip install yt-dlp

Workflow

Step 1: 자막 목록 확인

yt-dlp --list-subs "VIDEO_URL"

Step 2: 수동 자막 다운로드 (권장)

# 한국어 자막
yt-dlp --write-sub --sub-lang ko --skip-download "VIDEO_URL"

# 영어 자막
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"

Step 3: 자동 생성 자막 (폴백)

yt-dlp --write-auto-sub --sub-lang ko --skip-download "VIDEO_URL"

Step 4: VTT → 텍스트 변환

# VTT 파일에서 타임스탬프 제거
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.ko.vtt > transcript.txt

Output Processing

중복 제거

자동 생성 자막은 progressive 캡션으로 인해 중복이 많음:

# 중복 라인 제거
seen = set()
unique_lines = []
for line in lines:
    if line not in seen:
        seen.add(line)
        unique_lines.append(line)

요약 생성

추출된 자막으로:

핵심 내용 요약
타임스탬프별 챕터 생성
주요 키워드 추출

Examples

Example 1: 강의 영상 요약

User: 이 유튜브 강의 요약해줘 - https://youtube.com/watch?v=xxx

Claude:
1. yt-dlp로 자막 다운로드
2. VTT → 텍스트 변환
3. 핵심 내용 요약 생성
4. 타임스탬프별 목차 제공

Example 2: 다국어 자막 추출

User: 이 영상의 영어/한국어 자막 둘 다 추출해줘

Claude:
1. --list-subs로 가용 언어 확인
2. 각 언어별 자막 다운로드
3. 정리된 텍스트 파일 제공

Error Handling

에러	원인	해결책
`yt-dlp not found`	미설치	brew/apt/pip 설치
`No subtitles available`	자막 없음	Whisper 사용 제안
`Invalid URL`	URL 오류	URL 형식 확인
`Video unavailable`	비공개/삭제	사용자에게 알림

Whisper Fallback

자막이 전혀 없는 경우 (사용자 확인 필요):

# 파일 크기 확인
yt-dlp --print filesize "VIDEO_URL"

# 사용자 승인 후 오디오 다운로드
yt-dlp -x --audio-format mp3 "VIDEO_URL"

# Whisper로 변환
whisper audio.mp3 --language ko --model base

주의: 대역폭/처리 시간 소요로 사용자 확인 필수