speech-use
Generate (TTS), Transcribe (STT), and Clone voices using Google's GenAI and Cloud Speech SDKs. Supports Gemini-TTS, Chirp 3, and Instant Custom Voice.
How do I install this agent skill?
npx skills add https://github.com/cnemri/google-genai-skills --skill speech-useIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a set of utility scripts for Google Cloud speech services, including transcription, synthesis, and voice cloning. It uses official SDKs and follows standard authentication practices. No security issues were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
5/5 files flagged
What does this agent skill do?
Speech Use
Use this skill to perform Text-to-Speech (TTS), Speech-to-Text (STT), and Voice Cloning operations.
This skill uses portable Python scripts managed by uv.
Prerequisites
-
Environment Variables:
GOOGLE_API_KEY(for TTS via Gemini)GOOGLE_CLOUD_PROJECT(Required for STT and Voice Cloning)GOOGLE_APPLICATION_CREDENTIALS(Recommended for STT/Voice Cloning)
-
APIs Enabled:
- Text-to-Speech API (
texttospeech.googleapis.com) - Speech-to-Text API (
speech.googleapis.com)
- Text-to-Speech API (
Usage
1. Generate Speech (TTS)
Generate audio from text using Gemini-TTS.
Standard Voice:
uv run skills/speech-use/scripts/generate_speech.py "Hello world, this is a test." --voice Puck --output hello.wav
Custom Voice (Cloned):
uv run skills/speech-use/scripts/generate_speech.py "This is my custom voice speaking." --voice-cloning-key "YOUR_KEY_HERE" --output custom.wav
2. Create Custom Voice (Voice Cloning)
Generate a voiceCloningKey from a reference audio file and a consent file.
Requirements:
reference.wav: 10-30s of clear speech (the voice to clone).consent.wav: The speaker saying: "I am the owner of this voice and I consent to Google using this voice to create a synthetic voice model."
uv run skills/speech-use/scripts/create_custom_voice.py --reference-audio reference.wav --consent-audio consent.wav
Save the output key to use with generate_speech.py.
3. Transcribe Audio (STT)
Transcribe audio files using Chirp 3.
uv run skills/speech-use/scripts/transcribe_audio.py audio.wav --language en-US --output transcript.txt
Options
generate_speech.py
--voice: Prebuilt voice (e.g.,Kore,Puck,Fenrir,Aoede).--voice-cloning-key: Key fromcreate_custom_voice.py.--model: Defaultgemini-2.5-flash-preview-tts.
transcribe_audio.py
--model: Defaultchirp_3.--language: Defaultauto.--location: Cloud region (defaultus).
References
Before running scripts, review the reference guides for available voices and options.
- Voices Guide - 30+ voice options with styles (Puck, Kore, Fenrir, Aoede, etc.)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cnemri/google-genai-skills/speech-use">View speech-use on skillZs</a>