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

name, description

name	description
ppt-slide-extractor	유튜브 나레이션 대본에서 영상 송출용 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)

파일 생성 프로세스

# 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: 유튜브 영상 송출용 심플 장표 + 자동 파일 생성