This wraps the Google Cloud Text-to-Speech API so you can narrate documents, generate voiceovers, or create two-host podcast conversations from written content. It handles chunking for longer documents, supports 40+ languages with Neural2, WaveNet, and Studio voices, and can stitch multi-speaker JSON scripts into a single audio file with different voices per speaker. The podcast mode is clever if you want to turn a technical doc into a conversational audio format. Setup needs a Google Cloud API key and ffmpeg for longer files. Output defaults to MP3 in your Downloads folder. Neural2 voices hit a good balance between quality and cost at around $4 per million characters.

skills.sh installs
344
GitHub stars
454
last updated
Aug 21, 2026

Install

$ npx -y skills add sanjay3290/ai-skills --skill google-tts --agent claude-code

Installs into .claude/skills of the current project.

Files

Google Cloud Text-to-Speech

Converts text and documents into audio using Google Cloud TTS API. Supports Neural2, WaveNet, Studio, and Standard voices across 40+ languages.

Setup

API key via GOOGLE_TTS_API_KEY env var or skills/google-tts/config.json with {"api_key": "..."}. Requires ffmpeg for multi-chunk documents. Optional: pip install PyPDF2 python-docx for PDF/DOCX.

Commands

List Voices

python skills/google-tts/scripts/google_tts.py voices --language en-US --type Neural2
python skills/google-tts/scripts/google_tts.py voices --json

Text-to-Speech

# From text or document (PDF, DOCX, MD, TXT)
python skills/google-tts/scripts/google_tts.py tts --text "Hello world" --output ~/Downloads/hello.mp3
python skills/google-tts/scripts/google_tts.py tts --file /path/to/doc.pdf --output ~/Downloads/narration.mp3

# With voice, rate, pitch, encoding options
python skills/google-tts/scripts/google_tts.py tts --file doc.md --voice en-US-Neural2-F --rate 0.9 --encoding MP3 --output ~/Downloads/out.mp3

Podcast Generation

Takes a JSON script with alternating speakers, synthesizes each with a different voice.

Sponsors

Details

Repository
github.com/sanjay3290/ai-skills
Categories
Documentation, AI & Agent Building, Cloud & Infrastructure, Generative Media, Video & Audio Editing
License
Apache-2.0
First seen
Jun 3, 2026

More from sanjay3290/ai-skills

All 20
1guia-matthieu avatarstorytelling-storybrandguia-matthieu/clawfu-skillsMaster Donald Miller's 7-part StoryBrand framework from "Building a StoryBrand" (2017). Clarify your message so customers actually listen. Use when: Creating or343skills.sh installs
2rysweet avatarlearning-path-builderrysweet/amplihackCreates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon 342skills.sh installs
3pproenca avatar37signals-railspproenca/dot-skills37signals Rails coding principles and conventions from DHH, Jorge Manrubia, and the Fizzy/Basecamp/HEY codebase. This skill should be used when writing, reviewi340skills.sh installs
4arraydude avatarreact-query-best-practicesarraydude/agent-skillsReact Query v4 (TanStack Query) best practices, patterns, and troubleshooting. Use when working with useQuery, useMutation, query invalidation, caching, WebSock339skills.sh installs
5supabase avatarstudio-testingsupabase/supabaseTesting strategy for Supabase Studio. Use when writing tests, deciding whether a change needs tests and which type, extracting logic from components into testab337skills.sh installs
6yonatangross avatarwrite-prdyonatangross/orchestkitWrite PRD — Product Requirements Documents with structured 8-section templates, user stories, acceptance criteria, and value proposition validation. Use when wr336skills.sh installs