스킬: 비디오로 코스 만들기
최종 사용자용 유연한 가이드
버전: 2.0.0 마지막 업데이트: 2025-11-24 대상: 클라이언트/콘텐츠 제작자 방식: 대화형 진단 + 적응형 구조
목차
스킬 철학
핵심 원칙
┌─────────────────────────────────────────────────────────────────────┐
│ 구조 = f(콘텐츠) │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ 틀림: "모든 코스는 4개 섹션과 16개 모듈로 구성된다" │
│ │
│ ✅ 맞음: "구조는 콘텐츠 진단을 통해 결정된다" │
│ │
│ • 30분 영상 → 1개 모듈로 가능 │
│ • 50개 비디오 재생목록 → 5개 섹션, 각 10개 모듈 │
│ • 100시간 코스 → 추가 계층 구조 필요 │
│ │
└─────────────────────────────────────────────────────────────────────┘
고정되지 않은 것:
4개 섹션→ 콘텐츠에 따라 섹션 수 결정16개 모듈→ 분석 결과에 따라 모듈 수 결정32시간→ 실제 자료의 길이필수 플래시카드→ 필요에 따라 선택 사항
일관된 것:
- 대화형 진단 프로세스
- React/Tailwind 코드 패턴
- UX 명명 규칙 (섹션, 수업, 코스)
- 기존 시스템과의 통합
진단 흐름
단계 0: 정보 수집 (필수)
어떤 작업을 하기 전에, Claude는 다음을 수집해야 합니다:
┌─────────────────────────────────────────────────────────────────────┐
│ 초기 진단 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 입력 유형 │
│ □ 단일 비디오 (URL) │
│ □ YouTube 재생목록 (URL) │
│ □ 여러 개별 비디오 (URL 목록) │
│ □ 기존 시리즈/코스 (설명) │
│ │
│ 2. 콘텐츠 특징 │
│ • 예상 총 길이: ___ │
│ • 비디오 수: ___ │
│ • 주요 주제/주제: ___ │
│ • 대상 청중: ___ │
│ • 언어: ___ │
│ │
│ 3. 코스 목표 │
│ □ 빠른 입문/개요 │
│ □ 체계적인 완전 코스 │
│ □ 참고/조회 자료 │
│ □ 기업 교육 │
│ │
│ 4. 원하는 리소스 │
│ □ 섹션별 탐색 │
│ □ 진행 체크박스 │
│ □ 플래시카드 │
│ □ 실습 문제 │
│ □ 노트 작성 │
│ │
└─────────────────────────────────────────────────────────────────────┘
진단 질문 (Claude가 해야 함)
## 진단: 코스 제작
시작하기 전에, 콘텐츠에 대해 더 잘 이해해야 합니다:
1. **입력은 무엇인가요?**
- 단일 비디오 URL?
- 재생목록 URL?
- 개별 비디오 목록?
2. **전체 콘텐츠의 대략적인 길이는 얼마인가요?**
- 1시간 미만
- 1-5시간
- 5-20시간
- 20시간 초과
3. **코스 구조를 어떻게 상상하시나요?**
- 단일 모듈 (짧은 콘텐츠)
- 소수의 모듈 (2-5개)
- 섹션이 있는 완전한 구조
- 아직 모르겠음. 제안이 필요함
4. **어떤 리소스가 중요합니까?**
- 체크박스로 진행 상황 표시
- 복습용 플래시카드
- 간단한 탐색만
지원되는 입력 유형
형식 매트릭스
| 입력 유형 | 일반적인 길이 | 권장 구조 | 복잡성 |
|---|---|---|---|
| 단일 짧은 비디오 | < 1시간 | 1개 모듈, 선택적 섹션 | 낮음 |
| 단일 긴 비디오 | 1-5시간 | 3-8개 모듈, 1-2개 섹션 | 중간 |
| 매우 긴 비디오 | 5-20시간 | 여러 섹션 및 모듈 | 높음 |
| 작은 재생목록 | 5-10개 비디오 | 주제별 1개 섹션 | 중간 |
| 큰 재생목록 | 10-50개 비디오 | 그룹화된 여러 섹션 | 높음 |
| 매우 큰 재생목록 | 50+개 비디오 | 다중 레벨 계층 | 매우 높음 |
| 개별 비디오 | 다양함 | 사례별 분석 | 다양함 |
| 웨비나/라이브 | 1-3시간 | 타임스탬프가 있는 1개 모듈 | 낮음 |
자동 결정 vs. 대화형 결정
자동 (Claude 결정):
├── 코드 패턴 (React/Tailwind)
├── 파일 구조
├── 컴포넌트 명명 규칙
└── 기술 통합
대화형 (사용자 검증):
├── 섹션 수
├── 모듈 그룹화
├── 이름/제목
├── 선택적 리소스 (플래시카드 등)
└── 상세 수준
대화형 프로세스
커뮤니케이션 흐름
┌─────────────────────────────────────────────────────────────────────┐
│ 정렬 주기 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 사용자 Claude │
│ │ │ │
│ │──── "코스를 만들고 싶습니다" ──▶│ │
│ │ │ │
│ │◀─── 진단 질문 ─────────────────│ │
│ │ │ │
│ │──── 답변 ──────────────────────▶│ │
│ │ │ │
│ │◀─── 구조 제안 ─────────────────│ │
│ │ "입력을 기반으로, │ │
│ │ X개 섹션과 Y개 모듈을 │ │
│ │ 제안합니다. 동의하십니까?" │ │
│ │ │ │
│ │──── 조정/승인 ─────────────────▶│ │
│ │ │ │
│ │◀─── 실행 ──────────────────────│ │
│ │ │ │
└─────────────────────────────────────────────────────────────────────┘
구조 제안 템플릿
## 구조 제안
콘텐츠 분석을 기반으로 다음과 같이 제안합니다:
### 개요
- **총 길이:** [X시간]
- **형식:** [설명]
### 제안된 구조
**옵션 A: [설명적 이름]**
- [N]개 섹션
- 총 [M]개 모듈
- 리소스: [목록]
**옵션 B: [설명적 이름]**
- [N']개 섹션
- 총 [M']개 모듈
- 리소스: [목록]
### 세부 조정 질문
1. 어떤 옵션을 선호하시나요?
2. 그룹화에 대한 조정이 필요하신가요?
3. 리소스를 추가/제거하시겠습니까?
진행하기 전에 확인을 기다리겠습니다.
실행 단계
단계 1: 자막 추출
입력에 따라 적응:
# 단일 비디오
python youtube_transcript.py "URL_VIDEO"
# 재생목록 (먼저 목록 추출)
# Claude가 재생목록을 분석하고 그룹화 제안
# 여러 비디오
python youtube_transcript.py --batch lista_videos.txt
단계 2: 분석 및 제안
Claude가 분석하고 제안 (아직 실행하지 않음):
자막을 분석하여 다음을 확인했습니다:
- [X]개의 주요 주제
- [Y]개의 하위 주제
- 길이: [Z]시간
조직 제안:
[권장 구조]
이 구조로 진행할까요?
단계 3: 데이터 생성 (승인 후)
적응형 구조:
// 예시: 짧은 코스 (1개 비디오, 2시간)
export const fases[Nome] = [
{ id: 1, nome: "전체 콘텐츠", ... }
];
export const modulos[Nome] = [
{ id: '1.1', nome: '소개', ... },
{ id: '1.2', nome: '개념', ... },
{ id: '1.3', nome: '실습', ... }
];
// 예시: 긴 코스 (50개 비디오 재생목록)
export const fases[Nome] = [
{ id: 1, nome: "기초", ... },
{ id: 2, nome: "중급", ... },
{ id: 3, nome: "고급", ... },
{ id: 4, nome: "전문", ... },
{ id: 5, nome: "프로젝트", ... }
];
export const modulos[Nome] = [
// 5개 섹션에 걸쳐 50개 모듈
];
단계 4: 콘텐츠 변환
필요에 따른 상세 수준:
| 시나리오 | 상세 정도 | 컴포넌트 |
|---|---|---|
| 짧은 코스 | 최소 | LearningSystem만 |
| 중간 코스 | 기본 | LearningSystem + 기본 NotesView |
| 긴 코스 | 전체 | LearningSystem + 상세 NotesView + 플래시카드 |
단계 5: 통합
항상 필요:
studyAreas.js업데이트SistemaEducacionalCompleto.jsx업데이트
범위에 따라 선택:
- 각 모듈에 대한 NotesView 생성
- 플래시카드 생성
- 연습 문제 생성
변환 패턴
기본 변환 (모든 코스)
| 요소 | JSX |
|---|---|
| 제목 | <h2 className="text-2xl font-bold"> |
| 단락 | <p className="text-gray-700"> |
| 목록 | <ul className="list-disc"> |
중간 변환 (중급 코스 이상)
| 요소 | JSX |
|---|---|
| 코드 | <CodeBlock code={...}> |
| 경고 | <div className="bg-yellow-50 border"> |
| 강조 | <div className="bg-[cor]-100 p-4 rounded"> |
고급 변환 (긴 코스)
| 요소 | JSX |
|---|---|
| 타임라인 | 날짜/이벤트가 있는 Grid |
| 비교 | 2열 Grid |
| 다이어그램 | 사용자 정의 시각적 컴포넌트 |
| 인터랙티브 | React 상태 + 핸들러 |
시나리오별 예시
시나리오 1: 짧은 비디오 (45분)
입력: "Git 기초에 대한 45분 비디오가 있습니다"
진단:
- 유형: 단일 짧은 비디오
- 길이: < 1시간
- 목적: 입문
제안:
- 1개 단일 섹션
- 3-4개 모듈 (소개, 명령어, 브랜치, 실습)
- 플래시카드 없음 (선택 사항)
- 간단한 진행
결과:
├── gitLearningData.js (1개 단계, 4개 모듈)
└── GitLearningSystem.jsx (간단한 컴포넌트)
시나리오 2: 중간 재생목록 (20개 비디오, 15시간)
입력: "20개 비디오로 된 Docker 재생목록"
진단:
- 유형: 중간 재생목록
- 길이: ~15시간
- 목적: 완전 코스
제안:
- 4개 섹션 (기초, 이미지, Compose, 프로덕션)
- 20개 모듈 (비디오당 1개)
- 섹션별 플래시카드
- 상세 진행
결과:
├── dockerLearningData.js (4개 단계, 20개 모듈)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx (4개 파일, 섹션당 1개)
└── 통합된 플래시카드
시나리오 3: 거대 재생목록 (100+ 비디오)
입력: "Python 완전 코스, 150개 비디오"
진단:
- 유형: 매우 큰 재생목록
- 길이: 80시간+
- 목적: 완전 교육
대화형 제안:
"이것은 긴 코스입니다. 트랙으로 나누는 것을 제안합니다:
트랙 1: Python 기초 (30개 비디오)
트랙 2: Python 중급 (40개 비디오)
트랙 3: Python 고급 (40개 비디오)
트랙 4: 프로젝트 (40개 비디오)
각 트랙은 시스템에서 별도의 '코스'가 됩니다.
이 접근 방식에 동의하십니까?"
결과 (승인 후):
├── pythonBasicoLearningData.js
├── pythonIntermedLearningData.js
├── pythonAvancadoLearningData.js
├── pythonProjetosLearningData.js
└── 해당 컴포넌트
문제 해결
문제: 섹션 수를 모르겠음
해결: Claude가 다음을 기반으로 분석하고 제안:
- 자막의 주제 변화
- 블록의 상대적 길이
- 콘텐츠 복잡성
문제: 재생목록 비디오가 매우 이질적임
해결: Claude가 그룹화를 제안하고 검증 요청:
"재생목록에서 3가지 다른 주제를 확인했습니다:
- 비디오 1-8: 기초
- 비디오 9-15: 응용
- 비디오 16-20: 고급
이렇게 그룹화해도 될까요? 아니면 다른 구성을 원하시나요?"
문제: 콘텐츠가 완전한 구조를 만들기에 너무 짧음
해결: Claude가 최소 구조 제안:
"30분 분량의 콘텐츠만 있으므로 다음과 같이 제안합니다:
- 내부 섹션 3-4개가 있는 단일 모듈
- 별도의 NotesView 불필요
- 간단한 진행 (완료/미완료)
이 간소화된 접근 방식을 선호하시나요?"
문제: 자막을 사용할 수 없음
해결: Claude가 대안 제안:
"비디오에 자동 자막이 없습니다. 옵션:
1. 수동으로 자막 작성 (텍스트 제공)
2. 외부 자막 서비스 사용
3. 제목/설명 기반 구조 생성
4. 시청 후 주요 주제 기록
어느 것을 선호하시나요?"
참고 자료
관련 파일
…
[번역을 위해 잘림]