appkit/.claude/skills/ppt-slide-extractor/SKILL.md

---
name: ppt-slide-extractor
description: 유튜브 나레이션 대본에서 영상 송출용 PPT 장표를 추출. 각 장표마다 제목, 핵심 내용, 이미지 제안만 심플하게 제공. 시청자가 나레이션과 함께 보면서 내용을 이해할 수 있도록 시각적 보조 자료 생성. 결과는 새로운 md 파일로 저장. Use when users need YouTube video presentation slides.
---

# PPT Slide Extractor (유튜브 영상용 장표 추출기)

유튜브 나레이션 대본에서 영상에 삽입할 PPT 장표를 자동 추출하고 별도의 md 파일로 저장합니다.

## 📁 Templates & Output

**Template Location**: `.specify/templates/`
- `ppt-slides-output.md`: 전체 출력 구조 템플릿
- `ppt-slide-template.md`: 개별 슬라이드 템플릿

**Output File Naming**: `[원본파일명]_PPT장표.md`
- 예: `아무도 알려주지 않은 AI 수익화.md` → `아무도 알려주지 않은 AI 수익화_PPT장표.md`

**Output Location**: 원본 파일과 동일한 디렉토리

## 🎯 Core Purpose

**유튜브 영상 송출용 PPT 장표**
- 시청자가 나레이션 들으면서 보는 시각 자료
- 복잡한 설명을 단순화해서 전달
- 핵심 키워드와 이미지로 이해도 향상

**NOT for**:
- 오프라인 발표 자료 (X)
- 발표자 노트나 제스처 가이드 (X)
- 상세한 디자인 시안 (X)

---

## 📐 장표 추출 원칙

### 1장 = 1메시지
- 한 장표에 하나의 핵심만
- 텍스트는 최소한으로 (키워드 중심)
- 시청자가 3초 안에 파악 가능해야 함

### 영상 길이별 장표 수
- 10분 영상: 8-12장
- 15분 영상: 12-18장
- 평균: 1-1.5분당 1장

### 장표 필요 구간 vs 나레이션만 구간
- **장표 필수**: 숫자/데이터, 프로세스, 비교, 핵심 개념
- **나레이션만**: 스토리 전개, 개인적 경험담, 전환 멘트

---

## 🎨 장표 타입 (6가지)

### Type 1: 타이틀 슬라이드
**언제**: 영상 시작, 큰 섹션 전환
**구성**: 임팩트 제목 + 부제 (선택)
**예시**:
```
제목: AI로 월 300만원 버는 법
부제: 집에서 쉽게 시작하는 수익화
이미지: 노트북 + 돈 아이콘, 상승 그래프
```

---

### Type 2: 문제 제시
**언제**: 고통 포인트 강조
**구성**: 문제 키워드 3개
**예시**:
```
제목: 이런 고민 있으신가요?

❌ 3개월째 AI 공부 미루는 중
❌ 유료 결제했는데 안 씀
❌ "AI로 돈 번다는데?" 막막함

이미지: 고민하는 사람, 물음표, 복잡한 화면
```

---

### Type 3: 프로세스
**언제**: 단계별 방법 설명
**구성**: 단계 번호 + 핵심 행동
**예시**:
```
제목: AI 자동화 4단계

1️⃣ 태스크 나열
2️⃣ 그룹핑
3️⃣ 워크플로우 연결
4️⃣ AI 인수인계

이미지: 플로우차트, 화살표 다이어그램
```

---

### Type 4: 비교
**언제**: Before/After, A vs B
**구성**: 좌우 또는 상하 대비
**예시**:
```
제목: Web UI vs Claude Code

좌측: Web UI              우측: Claude Code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
매번 맥락 설명            프로젝트 이해
범용적 답변               맞춤형 답변
일관성 깨짐               지속 일관성

이미지: 좌측 혼란, 우측 깔끔 / VS 기호
```

---

### Type 5: 데이터
**언제**: 숫자, 통계, 사회적 증거
**구성**: 큰 숫자 + 보조 데이터
**예시**:
```
제목: 실제 사용자 성과

[대형 숫자]
300만원
(평균 월 수익)

👤 500명+ 실행
⏱️ 평균 2주 첫 수익
⭐ 만족도 4.8/5.0

이미지: 상승 그래프, 성공 아이콘
```

---

### Type 6: CTA
**언제**: 행동 유도 구간
**구성**: 3단계 깔때기
**예시**:
```
제목: 지금 바로 시작하세요

🎁 영상 저장 + 구독
💎 무료 PDF 다운
🚀 1:1 컨설팅 (선착순)

⏰ 이번 주 한정

이미지: 시작 버튼, 화살표, 밝은 미래
```

---

## 🤖 추출 프로세스

### Step 1: 대본 분석
```
사용자가 대본 제공 →
1. 원본 파일명 추출 (확장자 제거)
2. 타임스탬프로 전체 길이 파악
3. 섹션 구조 인식 (HOOK, PROBLEM, VALUE 등)
4. 장표 필요 구간 마킹
5. 예상 장표 수 계산 (1-1.5분당 1장)
```

### Step 2: 장표 추출
```
각 구간 순회하며:
1. 핵심 메시지 추출
2. 장표 타입 분류
3. 제목 생성 (5-8단어)
4. 키워드/내용 추출 (3-5개)
5. 이미지 제안 (간단히)
```

### Step 3: 파일 생성
```
1. 출력 파일명 생성: [원본파일명]_PPT장표.md
2. 템플릿 변수 치환:
   - {{VIDEO_TITLE}}: 영상 제목
   - {{VIDEO_LENGTH}}: 영상 길이
   - {{GENERATION_DATE}}: 생성 일시
   - {{TOTAL_SLIDES}}: 총 장표 수
   - {{TABLE_OF_CONTENTS}}: 목차
   - {{SLIDES_CONTENT}}: 모든 슬라이드 내용
   - {{SOURCE_FILE}}: 원본 파일명
3. Write 도구로 md 파일 생성
4. 생성된 파일 경로 사용자에게 안내
```

---

## 📋 출력 포맷

### 전체 구조
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 PPT 장표 추출 결과
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

영상: [제목]
길이: [10분]
장표: [10장]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📑 목차
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

#1  [0:00-0:15] 타이틀
#2  [0:15-0:45] 문제 제시
#3  [0:45-1:30] 실패 이유
#4  [2:00-3:00] 솔루션 비교
#5  [3:00-5:00] 프로세스
#6  [5:00-6:00] 실전 예시 1
#7  [6:00-7:00] 실전 예시 2
#8  [8:00-9:00] 데이터
#9  [9:00-9:30] 요약
#10 [9:30-10:00] CTA

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

### 각 슬라이드 포맷
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 SLIDE #[번호]: [타입]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⏰ [0:00-0:15]

제목: [5-8단어 임팩트]

내용:
[키워드 3-5개 OR 프로세스 단계 OR 비교 내용]

이미지:
[간단한 이미지 설명 1-2줄]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 💡 키워드 추출 로직

### 우선순위
1. **동사**: "시작하다", "분석하다" (행동 유도)
2. **숫자**: "300만원", "3단계" (구체성)
3. **대조**: "Before vs After", "X → O"
4. **감정**: "쉽게", "빠르게", "확실하게"

### 예시
```
대본:
"업무를 태스크로 나누고, 비슷한 것끼리 그룹핑한 다음,
워크플로우로 연결해서 AI에게 문서화하여 인수인계합니다."

추출 키워드:
1️⃣ 태스크 나열
2️⃣ 그룹핑
3️⃣ 워크플로우 연결
4️⃣ AI 인수인계
```

---

## 🖼️ 이미지 제안 가이드

### 타입별 이미지
| 장표 타입 | 이미지 방향 |
|-----------|-------------|
| 타이틀 | 강렬한 단일 이미지 (로켓, AI 로봇) |
| 문제 제시 | 고통/혼란 (미로, 물음표) |
| 프로세스 | 단계적 흐름 (화살표, 계단) |
| 비교 | 대조 쌍 (어두움↔밝음) |
| 데이터 | 신뢰 구축 (그래프, 별점) |
| CTA | 행동 촉구 (시작 버튼, 빛) |

### 제안 방식
- 구체적이되 간결하게
- 1-2줄로 요약
- 여러 옵션 나열하지 않음

---

## 💬 사용자 인터랙션

### 1️⃣ 대본 입력
```
사용자: "아무도 알려주지 않은 AI 수익화.md 파일로 PPT 만들어줘"

에이전트:
"📋 대본 분석 중...

원본 파일: 아무도 알려주지 않은 AI 수익화.md
영상 길이: 10분
예상 장표: 10-12장
출력 파일: 아무도 알려주지 않은 AI 수익화_PPT장표.md

추출을 시작할까요?"
```

---

### 2️⃣ 추출 진행 및 파일 생성
```
"🔄 장표 추출 중...
✅ 11장 추출 완료
📝 파일 생성 중...

✨ 완료!

생성된 파일:
/Users/.../아무도 알려주지 않은 AI 수익화_PPT장표.md

파일을 열어서 확인하시겠어요?"
```

---

### 3️⃣ 수정 요청
```
사용자: "SLIDE #5 너무 복잡해. 파일 수정해줘"

에이전트:
"💡 SLIDE #5 단순화 중...

변경사항:
현재: 4단계
개선: 3단계로 통합

1️⃣ 업무 쪼개기
2️⃣ 순서 정리
3️⃣ AI에게 맡기기

✅ 파일 업데이트 완료!"
```

---

## 🎯 실전 예시

### Input: 대본 샘플
```
## [2:00-4:00] SOLUTION INTRO

제가 두 그룹으로 나눠볼게요.

첫 번째 그룹: "가끔 쓰는 사람들"
- ChatGPT 가끔 질문
- 귀찮은 거만 부탁

두 번째 그룹: "지금 만드는 사람들"
- 매일 AI와 협업
- 내 맥락을 학습시킴

차이는? 첫 번째는 AI를 도구로 보고,
두 번째는 AI를 팀원으로 봅니다.
```

---

### Output: 추출 결과
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 SLIDE #4: 비교
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⏰ [2:00-4:00]

제목: AI 시대, 당신은 어느 그룹?

내용:
그룹 1: 가끔 쓰는 사람    |  그룹 2: 지금 만드는 사람
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 AI = 도구             |  👥 AI = 팀원
가끔 질문                |  매일 협업
귀찮은 것만              |  맥락 학습

이미지:
좌측은 어둡게 (계산기), 우측은 밝게 (팀 협업)
중앙에 VS 또는 화살표

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## ✅ 품질 기준

모든 장표는:
- ✅ 1장 = 1메시지
- ✅ 키워드 5개 이하
- ✅ 3초 안에 파악 가능
- ✅ 나레이션과 싱크
- ✅ 이미지 제안 간결

---

## 🚫 하지 말아야 할 것

### DON'T ❌
1. 대본 전체를 장표에 복사
2. 복잡한 차트나 그래프
3. 작은 글씨로 텍스트 많이
4. 애니메이션 효과 제안
5. 디자인 세부사항 (색상, 폰트 크기 등)
6. 발표자 노트, 제스처 가이드

### DO ✅
1. 핵심 키워드만 추출
2. 즉시 이해 가능한 구조
3. 나레이션 보조 역할
4. 시각적 메타포 활용
5. 심플하고 깔끔하게

---

## 📌 Activation Triggers

다음 요청 시 자동 활성화:
- "이 나레이션으로 PPT 만들어줘"
- "대본에서 장표 뽑아줘"
- "영상용 슬라이드 필요해"
- "유튜브 PPT 추출해줘"

파일 형식:
- `.md`, `.txt` (나레이션 대본)

---

## 🔧 실행 가이드 (Agent Implementation)

### 파일 생성 프로세스

```python
# Pseudo-code for implementation

# 1. 대본 파일 읽기
source_file = "아무도 알려주지 않은 AI 수익화.md"
source_content = Read(source_file)

# 2. 장표 추출
slides = extract_slides(source_content)
# returns: [{number, type, timestamp, title, content, image}, ...]

# 3. 메타데이터 생성
video_title = extract_title(source_content)
video_length = calculate_length(slides)
generation_date = current_datetime()
total_slides = len(slides)

# 4. 목차 생성
toc = generate_toc(slides)
# format: "#1  [0:00-0:15] 타이틀\n#2  [0:15-0:45] 문제 제시\n..."

# 5. 슬라이드 콘텐츠 생성
slides_content = ""
for slide in slides:
    slides_content += f"""
## SLIDE #{slide.number}: {slide.type}

**타임스탬프**: {slide.timestamp}

### 제목
{slide.title}

### 내용
{slide.content}

### 이미지
{slide.image}

---
"""

# 6. 최종 출력 파일 생성
output_filename = source_file.replace(".md", "_PPT장표.md")
output_content = f"""# {video_title}

**영상 길이**: {video_length}
**추출 일시**: {generation_date}
**장표 수**: {total_slides}장

---

## 📑 목차

{toc}

---

{slides_content}

---

## 💡 사용 가이드

### PPT 제작 시
1. 각 슬라이드의 **제목**을 슬라이드 상단에 배치
2. **내용**을 중앙에 큰 글씨로 (키워드는 bullet point)
3. **이미지** 설명을 참고하여 배경 또는 우측에 배치
4. 텍스트는 최소화, 시청자가 3초 안에 파악 가능하도록

### 영상 편집 시
- 각 슬라이드의 **타임스탬프**를 참고하여 나레이션과 싱크
- 슬라이드 전환은 부드럽게 (0.3-0.5초)
- 애니메이션은 최소화 (필요시 페이드 인만)

---

**Generated by**: PPT Slide Extractor v3.0
**Source**: {source_file}
"""

# 7. 파일 쓰기
Write(output_filename, output_content)

# 8. 사용자에게 안내
print(f"✨ 완료!\n\n생성된 파일:\n{output_filename}")
```

### 중요 구현 노트

1. **파일명 생성**: 원본 파일명에서 `.md` 제거 후 `_PPT장표.md` 추가
2. **경로 유지**: 원본 파일과 동일한 디렉토리에 생성
3. **Write 도구 사용**: Claude의 Write 도구로 파일 생성
4. **절대 경로**: Write 도구에 절대 경로 전달 필요
5. **인코딩**: UTF-8 인코딩 사용 (한글 지원)

### 에러 처리

- 원본 파일 없음: "파일을 찾을 수 없습니다" 안내
- 파일 쓰기 실패: 권한 확인 또는 경로 확인 안내
- 대본 구조 이상: "타임스탬프를 찾을 수 없습니다" 안내

---

**Version**: v3.0 (Template-based File Output)
**Last Updated**: 2025-11-08
**Focus**: 유튜브 영상 송출용 심플 장표 + 자동 파일 생성