YouTube video analysis → summary/insights/translation document generation → quiz test.
Workflow
1. Metadata collection
scripts/extract_metadata.sh "<URL>"
Extract: title, description, channel, upload_date, duration, tags
2. Transcript extraction
scripts/extract_transcript.sh "<URL>" [output_dir]
Priority: manual subtitles (ko→en) > auto-generated subtitles (ko→en)
3. Context identification (WebSearch)
Collect accurate spellings of proper nouns via web search:
"{영상 제목}" {채널명} summary"{발표자명}" {주제 키워드}
4. Transcript correction
Replace proper noun misrecognitions in auto subtitles with web search results:
- Kora → Cora, cloud code → Claude Code, every → Every.to
5. Document generation
---
title: {영상 제목}
url: {YouTube URL}
channel: {채널명}
date: {업로드 날짜}
duration: {영상 길이}
processed_at: {처리 일시}
---
# {영상 제목}
## 요약
{3-5문장 요약 + 주요 포인트 3개}
## 인사이트
### 핵심 아이디어
### 적용 가능한 점
## 전체 스크립트 (한글 번역)
[00:00] ...
6. File save
Location: research/readings/youtube/{YYYY-MM-DD}-{sanitized-title}.md
7. Learning quiz
3 levels × 3 questions = 9 questions total. Present 3 questions per level simultaneously with AskUserQuestion.
| Level | Difficulty | Question criteria |
|---|---|---|
| 1 | Basic | Key insights, main concepts |
| 2 | Intermediate | Insights + connecting detailed content |
| 3 | Advanced | Detailed content, application/analysis |
Question type details: references/quiz-patterns.md
Result handling
For incorrect answers, provide the correct answer and explanation, then add the quiz results at the end of the document:
## 퀴즈 결과
총점: 7/9 (78%) | 1단계 3/3 ✅ | 2단계 2/3 | 3단계 2/3
### 오답 노트
**Q5**: {질문}
- 선택: B → 정답: C
- {1-2문장 해설}
8. Follow-up options
After quiz completion, AskUserQuestion:
- Take another quiz: Retest with different questions
- Deep Research: In-depth web research (
references/deep-research.mdreference) - Exit: Finish
Notes
Subtitle language priority
- Korean manual → 2. English manual → 3. Korean auto → 4. English auto
Handling incomplete subtitles
- Proper noun misrecognition: batch replace in step 4
- Incomprehensible parts:
[불명확]mark
yt-dlp options
--list-subs: Check subtitle list--cookies-from-browser chrome: When login is required
Resources
scripts/extract_metadata.sh- Metadata extractionscripts/extract_transcript.sh- Subtitle extractionreferences/quiz-patterns.md- Quiz question type detailsreferences/deep-research.md- Deep Research workflow