TTS 스크립트 생성기은(는) 무엇을 하나요?
문서를 TTS(텍스트 음성 변환)에 적합한 스크립트로 지능적으로 압축하고 재작성합니다.
핵심 기능
- 🤖 AI 지능형 분석: Claude가 문서 내용을 분석하여 최적의 비디오 길이와 그림 스타일을 결정합니다.
- ⏱️ 스마트 길이 결정: 콘텐츠에 따라 적절한 길이(3-8분)를 자동으로 결정합니다.
- 🎨 스마트 스타일 결정: 주제에 따라 그림 스타일(뉴요커/우키요에/플랫/리얼리스틱 등)을 자동으로 선택합니다.
- 📉 스마트 압축: 최적 길이에 맞게 콘텐츠를 압축합니다(예: 19분 → 5분).
- 💬 구어체 변환: 문어체 → 자연스러운 구어체.
- 😊 감정 최적화: 감정 표현을 추가하여 TTS를 더 생동감 있게 만듭니다.
- 🎯 자동 분할: 콘텐츠에 따라 최적의 세그먼트 수를 결정합니다(각 10-20초).
- 📊 길이 예측: 각 세그먼트의 읽기 시간을 정확하게 계산합니다.
작동 원리
Claude 대화 내에서 실행:
- Claude가 원본 문서를 읽습니다.
- Claude가 콘텐츠를 분석합니다:
- 문서 주제와 구조
- 핵심 포인트 수
- 콘텐츠 밀도
- 최적 비디오 길이(3-8분) 결정
- 가장 적합한 그림 스타일 결정(예: 역사 → 우키요에, 기술 → 플랫, 인문 → 뉴요커)
- Claude가 지능적으로 재작성합니다:
- 핵심 포인트 추출
- 최적 길이에 맞춰 압축
- 구어체로 변환
- 감정 표현과 일시 정지 추가
- Claude가 자동으로 세그먼트를 분할합니다(각 세그먼트는 한 장의 그림에 적합).
- 문서 주제에 따라 가장 적합한 그림 스타일을 결정합니다.
- 각 세그먼트에 대한 그림 설명을 생성합니다(결정된 스타일 사용).
- 두 파일을 출력합니다:
tts_script.json(TTS 텍스트 스크립트 + 애니메이션 마커)visual_config.json(그림 설명, illustration-generator에서 사용)
tts_script.json 형식(애니메이션 마커 추가):
[
{
"segment": 1,
"text": "오늘은 당나라 실제 생활에 대해 이야기해볼까요? 타임슬립? 잠깐만요!",
"duration": 15,
"animation_style": "fade_in",
"emphasis": true
},
{
"segment": 2,
"text": "당나라에는 화장지가 없었어요. 그럼 뭘로 닦았을까요?",
"duration": 12,
"animation_style": "none",
"emphasis": false
}
]
애니메이션 마커 규칙(Claude 지능형 결정):
animation_style:"fade_in"- 제목, 오프닝, 강조 포인트"write"- 핵심 포인트, 주요 결론"typewriter"- 데이터, 사실 진술"none"- 일반 내용(ASS 자막 사용)
emphasis: 강조할 세그먼트인지 여부(true/false)
결정 원칙:
- 첫 번째 세그먼트(오프닝) →
fade_in - 핵심 포인트(각 챕터의 첫 번째 세그먼트) →
write - 데이터/사실 →
typewriter - 기타 내용 →
none(ASS 자막) - 권장: 24개 세그먼트 중 3-5개에만 애니메이션 적용
실행 스크립트
generate.py - TTS 스크립트 생성
python ~/.claude/skills/tts-script-generator/scripts/generate.py <마크다운_파일>
- 마크다운 파일 읽기
- H2 섹션 추출
- 구어체로 변환
- 길이에 따라 분할
tts_script.json출력
사용 시나리오
- 비디오 더빙: image-to-video와 함께 사용(주 용도)
- 팟캐스트 생성: podcast-generator와 함께 사용
출력 설명
이 스킬의 출력:
- ✅
tts_script.json- TTS 텍스트 스크립트 - ✅
visual_config.json- 그림 설명
포함하지 않음:
- ❌ TTS 오디오 생성(image-to-video 스킬이 담당)
- ❌ 그림 생성(illustration-generator 스킬 호출 필요)
- ❌ 비디오 합성(image-to-video 스킬 호출 필요)
호출 방식
image-to-video 스킬에 의해 자동 호출:
image-to-video가 긴 문서 감지
→ tts-script-generator 호출
→ Claude가 대화 내에서 재작성
→ 압축된 TTS 스크립트 출력
→ image-to-video가 계속 처리
수동 호출(Claude 대화 내):
사용자: "tts-script-generator로 이 문서를 재작성해줘"
Claude:
1. 문서 읽기(5,947자, 19분)
2. 콘텐츠 분석:
- 주제: 당나라 생활 과학(역사/인문類)
- 핵심 포인트: 4개(위생, 음식, 규제, 계급)
- 최적 길이 결정: 5분(콘텐츠 밀도 적절)
- 그림 스타일 결정: 우키요에(역사 주제, 동양 고전 미학)
3. 1,350자로 재작성
4. 20개 세그먼트로 분할(각 15초)
5. 각 세그먼트에 우키요에 스타일 그림 설명 생성
6. tts_script.json + visual_config.json 저장
출력 형식
tts_script.json
[
{
"segment": 1,
"text": "오늘은 당나라 실제 생활에 대해 이야기해볼까요? 타임슬립? 잠깐만요! 당나라에는 화장지가...",
"duration": 15
}
]
visual_config.json
{
"article_title": "당나라로의 타임슬립의 진실",
"style": "ukiyo-e",
"sections": [
{
"section": 1,
"visual_description": "현대 도시와 고대 당나라 궁전 사이 갈림길에 서서 당황한 표정의 한 사람, 우키요에 스타일, 전통 일본 목판화 미학"
}
]
}
그림 스타일 결정 규칙
Claude는 문서 주제에 따라 가장 적합한 스타일을 자동으로 선택합니다:
- 역사/고전類 →
ukiyo-e(우키요에): 당나라, 송나라, 일본 역사 등 - 인문/사회類 →
new-yorker(뉴요커): 사회 관찰, 인물 이야기 등 - 기술/비즈니스類 →
flat(플랫 스타일): 기술 제품, 비즈니스 분석 등 - 자연/여행類 →
realistic(리얼리스틱 스타일): 풍경, 동물, 여행 등 - 예술/창의類 →
abstract(추상 스타일): 예술 비평, 창의적 사고 등
재작성 원칙
- 핵심 유지: 가장 중요한 포인트와 이야기를 유지합니다.
- 구어체:
- "그러나" → "그런데"
- "왜냐하면...그래서..." → "왜 그럴까요? 그 이유는..."
- 감탄사 추가: "아", "그렇죠", "있잖아요"
- 감정 표현:
- 강조: "정말", "매우", "특별히"
- 감탄: "와", "세상에", "상상해보세요"
- 리듬 제어:
- 짧은 문장 위주
- 적절한 일시 정지
- 각 세그먼트 하나의 핵심 포인트
호출 가능
- image-to-video 스킬(주요)
- podcast-generator 스킬
- TTS가 필요한 기타 스킬