Communitygithub.com

ComeOnOliver/skillshub

다중 엔진 텍스트 음성 변환 스킬. Qwen3-TTS 로컬 음성 복제, VoiceCraft 온라인 TTS 및 OpenAI TTS를 지원합니다.

skillshub란 무엇인가요?

TTS-Skill은 여러 백엔드를 통해 음성을 생성할 수 있는 통합 진입점을 제공하는 AI 에이전트 스킬입니다. 개발자는 Qwen3-TTS의 로컬 음성 복제, edge-tts의 온라인 음성, OpenAI TTS API를 동일한 명령어 인터페이스로 사용할 수 있어, 프롬프트 엔지니어링이나 복잡한 설정 없이도 다양한 TTS 엔진을 쉽게 전환하고 활용할 수 있습니다. 본 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하도록 설계되었으며, `tts-skill.py`라는 단일 Python 스크립트를 통해 호출됩니다. 주요 기능으로는 일관된 출력 파일 이름 패턴, Qwen3-TTS 작업의 실시간 진행률 표시, 텍스트 파일 입력 지원, 그리고 음성 복제를 위한 로컬 음성 에셋 관리가 포함됩니다. 이를 통해 개발자는 음성 합성을 워크플로우에 통합하거나, 다양한 TTS 엔진의 결과를 비교해야 할 때 유용하게 사용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/tabortao/tts-skill

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

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

문서

🎙️ TTS-Skill — 다중 엔진 텍스트 음성 변환

TTS-Skill은 여러 백엔드를 사용하여 음성을 생성할 수 있는 단일 진입점을 제공하며, 일관된 출력 파일 이름 지정 및 장시간 작업에 대한 진행률 피드백을 지원합니다.

엔진

  • qwen3-tts: 참조 오디오 및 텍스트를 사용한 로컬 음성 복제
  • edge-tts: 속도/피치/스타일 제어가 가능한 온라인 음성
  • openai-tts: API를 통한 OpenAI 음성 생성

명령어 구문

/tts-skill [엔진] [텍스트] --voice [음성-키워드] [기타 옵션]

Python 진입점을 사용하는 경우:

python tts-skill.py [엔진] [텍스트] --voice [음성-키워드]

텍스트 입력

텍스트를 위치 인수로 전달하거나 --text-file / -f를 사용하여 파일에서 읽어옵니다.

예시:

python tts-skill.py qwen3-tts --text-file "input\\text.txt" --voice 寒冰射手

참고:

  • --text-file은 상대 경로와 절대 경로를 모두 지원하며, 상대 경로는 현재 작업 디렉터리를 기준으로 확인됩니다.
  • 위치 텍스트와 --text-file이 모두 제공된 경우 --text-file이 우선합니다.
  • UTF-8을 권장합니다(UTF-8 BOM 지원됨). 디코딩 오류 시 GBK로 대체됩니다.

엔진 스크립트를 직접 호출할 수도 있습니다:

python engines/qwen3-tts-cli.py --text-file "input\\text.txt" --voice 寒冰射手
python engines/edge-tts-cli.py --text-file "input\\text.txt" --voice xiaoxiao
python engines/openai-tts-cli.py --text-file "input\\text.txt" --voice alloy

로컬 음성 에셋 (Qwen3-TTS)

복제 음성을 추가하려면 assets/ 디렉터리에 다음과 같은 파일 쌍을 넣으세요:

assets/Lei.wav
assets/Lei.txt

지원되는 오디오 형식: .wav, .mp3, .m4a, .flac.

그런 다음 다음 명령어를 실행합니다:

python tts-skill.py qwen3-tts "테스트 텍스트" --voice Lei

출력

--output이 제공되지 않은 경우:

  • 출력 디렉터리: output/
  • 파일 이름 패턴: YYYYMMDD_HHMMSS_<첫-6자>.<확장자>

진행률 및 시간 (Qwen3-TTS)

Qwen3-TTS 작업은 예상 완료 시간(ETA)이 포함된 실시간 진행률 표시줄을 출력합니다. 완료 후 tts-skill.py는 다음 정보를 출력합니다:

  • 총 실행 시간
  • 총 문자 수 및 중국어 문자 수
  • 중국어 문자당 평균 초(중국어가 없는 경우 문자당)

프로젝트 구조

tts-skill/
├── .trae/
│   └── plans/
├── assets/
│   ├── Lei.txt
│   ├── 寒冰射手.txt
│   ├── 布里茨.txt
│   └── 赵信.txt
├── engines/
│   ├── edge-tts-cli.py
│   ├── edge-tts.config
│   ├── openai-tts-cli.py
│   ├── openai-tts.config
│   ├── qwen3-tts-cli.py
│   └── qwen3-tts.config
├── input/
│   └── text.txt
├── output/
├── tts-skill.py
├── INSTALL.md
├── INSTALL.zh-CN.md
├── README.md
├── README.zh-CN.md
├── SKILL.md
└── SKILL.zh-CN.md

중국어 사양

SKILL.zh-CN.md를 참조하세요.

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

관련 스킬