Communitygithub.com

TTS 스크립트 생성기

문서를 TTS에 최적화된 스크립트로 지능적으로 압축하고 재작성합니다. Claude AI를 사용하여 콘텐츠를 분석하고, 목표 길이에 맞게 압축하며, 구어체와 감정적 언어로 변환하고, 자동으로 분할합니다. 비디오 내레이션에 적합합니다.

TTS 스크립트 생성기란 무엇인가요?

이 스킬은 Claude AI를 활용하여 원본 문서를 TTS(텍스트 음성 변환)에 최적화된 스크립트로 변환하는 강력한 도구입니다. 주요 기능으로는 콘텐츠 분석을 통한 최적 비디오 길이(3-8분) 및 그림 스타일 결정, 핵심 요점 추출 후 목표 길이에 맞춘 지능적 압축, 구어체 및 감정적 표현으로의 변환, 각 세그먼트(10-20초)로의 자동 분할이 포함됩니다. 이 스킬은 두 가지 주요 출력 파일을 생성합니다: 'tts_script.json'(애니메이션 스타일과 강조 플래그가 포함된 TTS 텍스트 스크립트)과 'visual_config.json'(그림 스타일 및 각 세그먼트에 대한 시각적 설명). Claude는 콘텐츠 주제(역사/고전 → 우키요에, 인문/사회 → 뉴요커, 기술/비즈니스 → 플랫 등)에 따라 그림 스타일을 자동으로 결정합니다. 'image-to-video' 및 'podcast-generator'와 같은 다른 스킬에서 호출 가능하며, 특히 장문의 문서를 간결하고 매력적인 비디오 내레이션으로 변환하는 데 유용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/huangserva/servasyy_skills/tts-script-generator

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

TTS 스크립트 생성기은(는) 무엇을 하나요?

문서를 TTS(텍스트 음성 변환)에 적합한 스크립트로 지능적으로 압축하고 재작성합니다.

핵심 기능

  • 🤖 AI 지능형 분석: Claude가 문서 내용을 분석하여 최적의 비디오 길이와 그림 스타일을 결정합니다.
  • ⏱️ 스마트 길이 결정: 콘텐츠에 따라 적절한 길이(3-8분)를 자동으로 결정합니다.
  • 🎨 스마트 스타일 결정: 주제에 따라 그림 스타일(뉴요커/우키요에/플랫/리얼리스틱 등)을 자동으로 선택합니다.
  • 📉 스마트 압축: 최적 길이에 맞게 콘텐츠를 압축합니다(예: 19분 → 5분).
  • 💬 구어체 변환: 문어체 → 자연스러운 구어체.
  • 😊 감정 최적화: 감정 표현을 추가하여 TTS를 더 생동감 있게 만듭니다.
  • 🎯 자동 분할: 콘텐츠에 따라 최적의 세그먼트 수를 결정합니다(각 10-20초).
  • 📊 길이 예측: 각 세그먼트의 읽기 시간을 정확하게 계산합니다.

작동 원리

Claude 대화 내에서 실행:

  1. Claude가 원본 문서를 읽습니다.
  2. Claude가 콘텐츠를 분석합니다:
    • 문서 주제와 구조
    • 핵심 포인트 수
    • 콘텐츠 밀도
    • 최적 비디오 길이(3-8분) 결정
    • 가장 적합한 그림 스타일 결정(예: 역사 → 우키요에, 기술 → 플랫, 인문 → 뉴요커)
  3. Claude가 지능적으로 재작성합니다:
    • 핵심 포인트 추출
    • 최적 길이에 맞춰 압축
    • 구어체로 변환
    • 감정 표현과 일시 정지 추가
  4. Claude가 자동으로 세그먼트를 분할합니다(각 세그먼트는 한 장의 그림에 적합).
  5. 문서 주제에 따라 가장 적합한 그림 스타일을 결정합니다.
  6. 각 세그먼트에 대한 그림 설명을 생성합니다(결정된 스타일 사용).
  7. 두 파일을 출력합니다:
    • 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)

결정 원칙:

  1. 첫 번째 세그먼트(오프닝) → fade_in
  2. 핵심 포인트(각 챕터의 첫 번째 세그먼트) → write
  3. 데이터/사실 → typewriter
  4. 기타 내용 → none(ASS 자막)
  5. 권장: 24개 세그먼트 중 3-5개에만 애니메이션 적용

실행 스크립트

generate.py - TTS 스크립트 생성

python ~/.claude/skills/tts-script-generator/scripts/generate.py <마크다운_파일>
  • 마크다운 파일 읽기
  • H2 섹션 추출
  • 구어체로 변환
  • 길이에 따라 분할
  • tts_script.json 출력

사용 시나리오

  1. 비디오 더빙: image-to-video와 함께 사용(주 용도)
  2. 팟캐스트 생성: 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(추상 스타일): 예술 비평, 창의적 사고 등

재작성 원칙

  1. 핵심 유지: 가장 중요한 포인트와 이야기를 유지합니다.
  2. 구어체:
    • "그러나" → "그런데"
    • "왜냐하면...그래서..." → "왜 그럴까요? 그 이유는..."
    • 감탄사 추가: "아", "그렇죠", "있잖아요"
  3. 감정 표현:
    • 강조: "정말", "매우", "특별히"
    • 감탄: "와", "세상에", "상상해보세요"
  4. 리듬 제어:
    • 짧은 문장 위주
    • 적절한 일시 정지
    • 각 세그먼트 하나의 핵심 포인트

호출 가능

  • image-to-video 스킬(주요)
  • podcast-generator 스킬
  • TTS가 필요한 기타 스킬

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬