Communitygithub.com

ElevenLabs TTS

ElevenLabs 텍스트-음성 변환 오디오 생성. 사용자가 ElevenLabs, TTS, 내레이션, 음성 해설을 요청할 때 사용합니다.

ElevenLabs TTS란 무엇인가요?

이 스킬은 ElevenLabs API를 통해 텍스트를 자연스러운 음성 오디오로 변환하는 기능을 제공합니다. 로컬 JSON 설정 파일에서 음성 프로필을 불러와 사용하며, API 키는 환경 변수로 관리해 보안을 유지합니다. 지원하는 플랫폼은 Claude Code, Cursor, Codex 등 AI 에이전트와 통합 가능하며, 명령줄에서 직접 실행할 수도 있습니다. 주요 특징으로는 여러 음성 프로필을 로컬에서 관리하고, 인라인 텍스트나 파일 기반 스크립트를 지원하며, 다양한 오디오 출력 포맷과 음성 설정을 세밀하게 조정할 수 있습니다. 또한 --dry-run 옵션으로 실제 호출 전에 요청 내용을 확인할 수 있고, --list-voices로 ElevenLabs에서 사용 가능한 음성을 검색할 수 있습니다. 이 스킬은 사용자의 API 키, 음성 이름, 이메일 등 개인 정보를 스킬 내에 저장하지 않으며, 모든 계정별 설정은 스킬 외부의 로컬 설정 파일에서 읽어옵니다. 이렇게 함으로써 재사용성과 보안을 동시에 확보합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/codex/elevenlabs-tts

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

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

문서

ElevenLabs TTS은(는) 무엇을 하나요?

이 스킬을 ElevenLabs 텍스트-음성 변환 생성에 사용합니다. 스킬을 재사용 가능하고 개인 정보가 없도록 유지하세요:

  • API 키, 음성 이름, 음성 ID, 이메일, 계정 이름, 고객 이름 또는 개인 기본값을 스킬에 저장하지 마세요.
  • ELEVENLABS_API_KEY는 프로세스 환경 또는 가장 가까운 .env 파일에서 읽어옵니다.
  • 계정별 음성 프로필은 이 스킬 외부의 로컬 JSON 설정에서 읽어옵니다.
  • 요청 수준 설정으로 오디오를 생성하세요. 사용자가 명시적으로 요청하지 않는 한 저장된 ElevenLabs 계정 또는 음성 설정을 변경하지 마세요.

로컬 프로필

다음 설정 소스를 우선 순위대로 선호합니다:

  1. --config /path/to/profiles.json
  2. ELEVENLABS_TTS_CONFIG=/path/to/profiles.json
  3. local/elevenlabs/profiles.json

프로젝트 로컬 프로필 파일도 gitignore 되어 있다면 괜찮습니다. 예: config/local/elevenlabs-tts.json

도우미 스크립트는 다음 형태를 기대합니다:

{
  "default_profile": "default",
  "profiles": {
    "default": {
      "voice_name": "로컬 계정의 음성 이름",
      "voice_id": "선택적-직접-음성-id",
      "voice_id_env": "OPTIONAL_ENV_VAR_WITH_VOICE_ID",
      "model_id": "eleven_multilingual_v2",
      "output_format": "mp3_44100_128",
      "voice_settings": {
        "stability": 0.5,
        "similarity_boost": 1.0,
        "style": 0.0,
        "speed": 1.0,
        "use_speaker_boost": true
      },
      "output_dir": "outputs/voiceovers",
      "emails": []
    }
  }
}

emails, 소유자, 별칭, 메모와 같은 필드는 로컬 라우팅/컨텍스트 전용입니다. 스크립트는 알 수 없는 메타데이터 필드를 무시합니다.

워크플로우

  1. --profile, ELEVENLABS_TTS_PROFILE 또는 default_profile에서 프로필을 선택합니다.
  2. 도우미 스크립트를 우선 사용합니다: python3 <skill-root>/scripts/generate_voice.py --text-file script.txt --profile default --output output.mp3
  3. 프로필에 voice_id가 있으면 사용합니다. voice_id_env가 있으면 해당 환경 변수를 읽어옵니다. 그렇지 않으면 voice_name으로 ElevenLabs를 검색합니다.
  4. 사용자가 이번 생성에서 재정의하지 않는 한 프로필의 model_id, output_format, voice_settings를 사용합니다.
  5. 생성된 오디오를 요청된 대상에 넣습니다. 대상이 주어지지 않으면 프로필의 output_dir, 그 다음 outputs/voiceovers/를 사용합니다.
  6. 출력 경로와 중요한 경고를 보고합니다. 비밀을 출력하지 마세요.

도우미 스크립트

번들 스크립트는 다음을 지원합니다:

  • --text "..." 인라인 텍스트
  • --text-file path.txt 스크립트 파일
  • --text 및 --text-file이 모두 제공되지 않은 경우 표준 입력
  • --profile name 로컬 프로필 선택
  • --config path.json 로컬 프로필 파일 선택
  • --voice-id, --voice-name, --model-id, --output-format, --settings-json 일회성 재정의
  • --output path.mp3 출력 파일 선택
  • --dry-run 텍스트-음성 변환 엔드포인트를 호출하지 않고 해결된 요청 페이로드 출력
  • --list-voices 오디오를 생성하지 않고 일치하는 ElevenLabs 음성 목록 출력

API 참고

최신 ElevenLabs 엔드포인트를 사용하세요:

  • 음성 검색: GET https://api.elevenlabs.io/v2/voices
  • 음성 생성: POST https://api.elevenlabs.io/v1/text-to-speech/:voice_id?output_format=...

API 키는 xi-api-key로 보내세요.

Individual skills in this repo

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

MengTo/Skills

Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography, zoom-follow framing, ffprobe/thumbnail verification, and optional native recording compatibility checks. Use when the user asks to record or re-record browser actions, show cursor clicks and zooms, make Dribbble/UI inspiration or product demo recordings, or asks whether Codex, Playwright, or an MCP can produce a natural browser demo video.

MengTo/Skills

Profile, audit, and optimize frontend page performance with emphasis on animation work, memory-leak risks, long-session slowdowns, CSS animations, canvas/WebGL requestAnimationFrame loops, marquees, skeletons, GSAP/Three/Matter effects, timers, listeners, and observers. Use when the user asks to make animations performant, pause offscreen animations, look for memory leaks, profile pages that slow the computer over time, fix janky scrolling, reduce CPU/GPU use, or repeat the "only play in view" optimization on React/Vite/Next/frontend pages using Codex Browser.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Create cinematic scroll-driven landing pages with Lenis smooth scrolling, GSAP ScrollTrigger, scroll-linked progression, staggered text reveals, sticky card stacks, parallax backgrounds, scroll-scrubbed transitions, footer reveals, and immersive preloaders. Use when analyzing or building premium editorial scroll experiences, sticky project stacks, kinetic typography, or section-by-section storytelling.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

관련 스킬