Communitygithub.com

YouTube 요약기

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

YouTube 요약기란 무엇인가요?

이 스킬은 YouTube 동영상 URL을 입력받아 자동으로 자막을 추출하고, STAR + R-I-S-E 프레임워크를 활용하여 심층적이고 구조화된 요약을 생성합니다. 사용자가 제공한 URL의 유효성을 검사하고, `youtube-transcript-api` Python 라이브러리를 사용하여 자막을 추출한 후, 동영상의 주요 통찰, 핵심 주장, 개념 및 용어를 상세히 기록한 마크다운 문서를 출력합니다. 특히 교육, 강의, 튜토리얼 등 정보 전달 목적의 콘텐츠를 분석하는 데 최적화되어 있어, 사용자가 동영상을 다시 시청하지 않고도 내용을 완전히 파악하고 참고 자료로 활용할 수 있도록 돕습니다. 주요 기능에는 URL 형식 자동 검증, 자막 언어 선택, 진행 상태 시각적 표시, 구조화된 요약 출력, 파일 저장 옵션 등이 포함됩니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/sickn33/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가 성공적으로 설치되었습니다')"

주요 워크플로우

진행 상황 추적 지침

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

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

형식 사양:

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

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

╔══════════════════════════════════════════════════════════════╗
║     📹  YouTube 요약기 - 동영상 처리 중                      ║
╠══════════════════════════════════════════════════════════════╣
║ → 1단계: URL 검증                 [진행 중]                   ║
║ ○ 2단계: 접근 가능 여부 확인                                ║
║ ○ 3단계: 자막 추출                                        ║
║ ○ 4단계: 요약 생성                                         ║
║ ○ 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% - 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% - 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% - 4/5단계: 요약 생성 중"

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

적용되는 프롬프트:

추출된 자막을 입력으로 사용하여 Phase 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"  # 컨텍스트로 자막 읽기

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

5단계: 출력 형식 지정 및 제공

진행:

echo "[████████████████████] 100% - 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가 설치되지 않았습니다

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

지금 설치하시겠습니까?

  • 예 - pip로 설치
  • 아니요 - 수동으로 설치하겠습니다

**사용자가 "예"를 선택:**

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

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

예시 4: 잘못된 URL

사용자 입력:

claude> 유튜브 동영상 요약 www.youtube.com/some-video

스킬 응답:

❌ 잘못된 YouTube URL 형식입니다

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

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

📊 실행 요약

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

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


**저장 옵션:**

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

✅ 파일 저장됨: 요약-예시123-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.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬