Communitygithub.com

유튜브 요약기

YouTube 동영상에서 자막을 추출하고 지능형 분석 프레임워크를 사용하여 포괄적이고 상세한 요약을 생성합니다.

유튜브 요약기란 무엇인가요?

이 스킬은 YouTube 동영상의 자막을 추출하고 STAR + R-I-S-E 프레임워크를 사용하여 상세하고 체계적인 요약을 생성합니다. 동영상 URL을 검증하고, `youtube-transcript-api` Python 라이브러리를 통해 자막 접근 가능 여부를 확인한 후 자막을 추출합니다. 교육용 비디오, 강의, 튜토리얼 또는 정보성 콘텐츠의 철저한 내용 분석과 참조 문서를 필요로 하는 사용자를 위해 설계되었습니다. 주요 기능으로는 URL 유효성 검사, 자막 언어 선택 (기본 포르투갈어, 영어 폴백), 자동 진행률 표시, 구조화된 마크다운 출력 (메타데이터, 구역별 분석, 핵심 인사이트, 용어집 등)이 포함됩니다. 주요 제한 사항으로는 자막이 비활성화된 동영상, 비공개 또는 제한된 동영상, 자동 생성 자막이 없는 동영상은 처리할 수 없습니다. Claude, Cursor 및 유사한 AI 에이전트 플랫폼에서 작동하며, 자막 추출을 위해 외부 Python 라이브러리에 의존하므로 종속성 확인 및 설치 과정이 필요할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/skills/youtube-summarizer

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

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

문서

youtube-summarizer

목적

이 스킬은 YouTube 동영상에서 자막을 추출하고 STAR + R-I-S-E 프레임워크를 사용하여 포괄적이고 상세한 요약을 생성합니다. 동영상 접근 가능 여부를 확인하고, youtube-transcript-api Python 라이브러리를 사용하여 자막을 추출한 후 모든 인사이트, 논증 및 핵심 사항을 포착한 상세 문서를 생성합니다.

이 스킬은 교육용 비디오, 강의, 튜토리얼 또는 정보성 콘텐츠에 대한 철저한 내용 분석과 참조 문서가 필요한 사용자를 위해 설계되었습니다.

이 스킬을 사용해야 하는 경우

이 스킬은 다음과 같은 경우에 사용해야 합니다:

  • 사용자가 YouTube 동영상 URL을 제공하고 상세한 요약을 원할 때
  • 사용자가 다시 시청하지 않고 동영상 콘텐츠를 문서화하여 참조해야 할 때
  • 사용자가 교육 콘텐츠에서 인사이트, 핵심 사항 및 논증을 추출하려 할 때
  • 사용자가 분석을 위해 YouTube 동영상의 자막이 필요할 때
  • 사용자가 YouTube 동영상을 "요약", "정리" 또는 "콘텐츠 추출"해 달라고 요청할 때
  • 사용자가 간결함보다 완전성을 우선시하는 포괄적인 문서를 원할 때

0단계: 환경 확인 및 설정

동영상을 처리하기 전에 환경과 종속성을 확인합니다:

# youtube-transcript-api가 설치되어 있는지 확인
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api가 설치되지 않음"
    # 설치 제안
fi

# Python 사용 가능 여부 확인
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3이 필요하지만 설치되지 않음"
    exit 1
fi

종속성이 누락된 경우 사용자에게 문의:

youtube-transcript-api가 필요하지만 설치되지 않았습니다.

지금 설치하시겠습니까?
- [ ] 예 - pip로 설치 (pip install youtube-transcript-api)
- [ ] 아니오 - 수동으로 설치하겠습니다

사용자가 "예"를 선택한 경우:

pip install youtube-transcript-api

설치 확인:

python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installed successfully')"

주요 워크플로우

진행률 추적 지침

워크플로우 전반에 걸쳐 각 단계 전에 시각적 진행률 게이지를 표시하여 사용자에게 정보를 제공합니다. 게이지 형식은 다음과 같습니다:

echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: URL 검증"

형식 사양:

  • 20자 너비 (채워짐: █, 비어있음: ░)
  • 백분율 증가: 1단계=20%, 2단계=40%, 3단계=60%, 4단계=80%, 5단계=100%
  • 현재/전체 단계 카운터 (예: "Step 3/5")
  • 현재 단계에 대한 간단한 설명

1단계 전에 초기 상태 상자를 표시:

╔══════════════════════════════════════════════════════════════╗
║     📹  YouTube 요약기 - 동영상 처리                          ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: URL 검증                   [진행 중]               ║
║ ○ Step 2: 접근 가능 여부 확인                                ║
║ ○ Step 3: 자막 추출                                        ║
║ ○ Step 4: 요약 생성                                         ║
║ ○ Step 5: 출력 형식 지정                                     ║
╠══════════════════════════════════════════════════════════════╣
║ 진행률: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%                 ║
╚══════════════════════════════════════════════════════════════╝

1단계: YouTube URL 검증

목표: 동영상 ID를 추출하고 URL 형식을 검증합니다.

지원되는 URL 형식:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://m.youtube.com/watch?v=VIDEO_ID

작업:

# 정규식 또는 URL 파싱을 사용하여 동영상 ID 추출
URL="$USER_PROVIDED_URL"

# 패턴 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# 패턴 2: youtu.be/VIDEO_ID  
elif echo "$URL" | grep -qE 'youtu\.be/'; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
    echo "❌ 잘못된 YouTube URL 형식"
    exit 1
fi

echo "📹 동영상 ID 추출됨: $VIDEO_ID"

URL이 유효하지 않은 경우:

❌ 잘못된 YouTube URL

다음 형식 중 하나로 유효한 YouTube URL을 제공해 주세요:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

예시: https://www.youtube.com/watch?v=dQw4w9WgXcQ

2단계: 동영상 및 자막 접근 가능 여부 확인

진행률:

echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: 접근 가능 여부 확인"

목표: 동영상이 존재하고 자막에 접근할 수 있는지 확인합니다.

작업:

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # 사용 가능한 자막 목록 가져오기
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ 동영상 접근 가능: {video_id}")
    print("📝 사용 가능한 자막:")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [자동 생성]")
    
except TranscriptsDisabled:
    print(f"❌ 동영상 {video_id}의 자막이 비활성화됨")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ 동영상 {video_id}에 대한 자막을 찾을 수 없음")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ 동영상 접근 오류: {e}")
    sys.exit(1)

오류 처리:

오류메시지조치
동영상을 찾을 수 없음"❌ 동영상이 존재하지 않거나 비공개입니다"사용자에게 URL 확인 요청
자막 비활성화"❌ 이 동영상의 자막이 비활성화되었습니다"계속할 수 없음
자막 없음"❌ 자막을 찾을 수 없음 (자동 생성 또는 수동 추가되지 않음)"계속할 수 없음
비공개/제한된 동영상"❌ 동영상이 비공개 또는 제한되어 있습니다"공개 동영상 요청

3단계: 자막 추출

진행률:

echo "[████████████░░░░░░░░] 60% - Step 3/5: 자막 추출"

목표: 선호하는 언어로 자막을 검색합니다.

작업:

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # 먼저 사용자가 선호하는 언어로 자막 가져오기 시도
    # 사용 불가능한 경우 영어로 폴백
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # 포르투갈어 우선, 영어로 폴백
    )
    
    # 자막 세그먼트를 전체 텍스트로 결합
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # 동영상 메타데이터 가져오기
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ 자막이 성공적으로 추출되었습니다")
    print(f"📊 자막 길이: {len(full_text)} 문자")
    
    # 처리를 위해 임시 파일에 저장
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ 자막 추출 오류: {e}")
    exit(1)

자막 처리:

  • 모든 자막 세그먼트를 일관된 텍스트로 결합
  • 가능한 경우 구두점 및 서식 유지
  • 중복되거나 겹치는 세그먼트 제거 (자동 생성 아티팩트인 경우)
  • 분석을 위해 임시 파일에 저장

4단계: 포괄적인 요약 생성

진행률:

echo "[████████████████░░░░] 80% - Step 4/5: 요약 생성"

목표: 향상된 STAR + R-I-S-E 프롬프트를 적용하여 상세한 요약을 생성합니다.

적용 프롬프트:

2단계의 향상된 프롬프트(STAR + R-I-S-E 프레임워크)를 추출된 자막을 입력으로 사용하여 적용합니다.

작업:

  1. 전체 자막 텍스트 로드
  2. 포괄적인 요약 프롬프트 적용
  3. AI 모델(Claude/GPT)을 사용하여 구조화된 요약 생성
  4. 출력이 정의된 구조를 따르는지 확인:
    • 동영상 메타데이터가 포함된 헤더
    • 실행 요약
    • 구역별 상세 분석
    • 핵심 인사이트 및 결론
    • 개념 및 용어
    • 리소스 및 참고 자료

구현:

# 자막 파일을 AI 프롬프트 입력으로 사용
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"

# AI 에이전트는:
# 1. 자막을 읽음
# 2. STAR + R-I-S-E 요약 프레임워크를 적용
# 3. 포괄적인 마크다운 출력을 생성
# 4. 헤더, 목록, 강조 표시로 구조화

Read "$TRANSCRIPT_FILE"  # 자막을 컨텍스트로 읽기

그런 다음 전체 요약 프롬프트(2단계의 향상된 버전에서)를 적용합니다.

5단계: 출력 형식 지정 및 표시

진행률:

echo "[████████████████████] 100% - Step 5/5: 출력 형식 지정"

목표: 깔끔하고 잘 구조화된 마크다운으로 요약을 제공합니다.

출력 구조:

# [동영상 제목]

**채널:** [채널 이름]  
**길이:** [길이]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**게시 날짜:** [날짜 사용 가능한 경우]


## 📝 상세 요약

### [주제 1]

[예시, 데이터, 인용문을 포함한 포괄적인 설명...]

#### [하위 주제 1.1]

[상세 분석...]

### [주제 2]

[계속되는 상세 분석...]


## 📚 개념 및 용어

- **[용어 1]:** [정의 및 맥락]
- **[용어 2]:** [정의 및 맥락]


## 📌 결론

[최종 요약 및 핵심 내용]

예시 2: 종속성 누락

사용자 입력:

claude> youtube 동영상 https://youtu.be/abc123 요약해 줘

스킬 응답:

⚠️  youtube-transcript-api가 설치되지 않음

이 스킬은 'youtube-transcript-api' Python 라이브러리가 필요합니다.

지금 설치하시겠습니까?
- [ ] 예 - pip로 설치
- [ ] 아니오 - 수동으로 설치하겠습니다

사용자가 "예"를 선택:

$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ 설치 완료! 동영상 요약을 진행합니다...

예시 4: 잘못된 URL

사용자 입력:

claude> youtube 동영상 www.youtube.com/some-video 요약해 줘

스킬 응답:

❌ 잘못된 YouTube URL 형식

예상 형식 예시:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

유효한 YouTube 동영상 URL을 제공해 주세요.

📊 실행 요약

이 동영상은 초보자와 현대 AI의 기술적 기초와 실제 응용 프로그램을 이해하려는 전문가를 대상으로 인공지능(AI)의 기본 개념에 대한 포괄적인 소개를 제공합니다. 강사는 기본 정의부터 머신러닝 알고리즘까지 모든 것을 다루며, 이해를 돕기 위해 실제 예제와 시각 자료를 사용합니다.

[계속되는 상세 요약...]


**저장 옵션:**

무엇을 저장하시겠습니까? → 요약 + 원본 자막

✅ 파일 저장됨: resumo-exemplo123-2026-02-01.md (원본 자막 포함) [████████████████████] 100% - ✓ 처리 완료!

머신러닝 기초에 대한 이 포괄적인 튜토리얼에 오신 것을 환영합니다. 오늘의 동영상에서는 현대 AI 시스템을 구동하는 핵심 개념을 살펴보겠습니다...


**버전:** 1.2.0
**마지막 업데이트:** 2026-02-02
**유지 관리자:** Eric Andrade

## 제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확하게 일치하는 경우에만 사용하십시오.
- 출력을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 것으로 취급하지 마십시오.
- 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중지하고 명확한 설명을 요청하십시오.

Individual skills in this repo

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

AbobakrDiara61/railway-system

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

AbobakrDiara61/railway-system

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

AbobakrDiara61/railway-system

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

AbobakrDiara61/railway-system

One sentence - what this skill does and when to invoke it

AbobakrDiara61/railway-system

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AbobakrDiara61/railway-system

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

AbobakrDiara61/railway-system

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AbobakrDiara61/railway-system

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

AbobakrDiara61/railway-system

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

AbobakrDiara61/railway-system

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

AbobakrDiara61/railway-system

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

AbobakrDiara61/railway-system

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

AbobakrDiara61/railway-system

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

AbobakrDiara61/railway-system

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

AbobakrDiara61/railway-system

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

AbobakrDiara61/railway-system

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

AbobakrDiara61/railway-system

One sentence - what this skill does and when to invoke it

AbobakrDiara61/railway-system

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

관련 스킬