Our review
Generates audio content via the Runway API, including text-to-speech, sound effects, voice isolation, dubbing, and voice conversion.
Strengths
- Supports multiple audio generation types
- Simple command-line parameterization
- Variety of preset voices available
- Direct integration with Runway API
Limitations
- Requires a valid Runway API key
- Depends on Runway API availability
- Audio files must be accessible via URL or local path
Best for quickly generating audio files from text or processing existing audio files without a GUI.
Avoid for complex audio production workflows requiring multi-track editing or real-time processing.
Security analysis
SafeThe skill leverages only standard read/write/execute operations via uv run to call the Runway API. There are no destructive commands, no secrets exfiltration, no obfuscation, and no attempts to disable safety controls. It operates within the allowed-tools constraints and directly fulfills its described purpose.
No concerns found
Examples
Generate a text-to-speech audio for 'Welcome to our product showcase' and save it as voiceover.mp3 using Runway API.Create a sound effect of thunder rolling across a stormy sky and save it as thunder.mp3.Isolate the voice from the audio file noisy-recording.mp3 and save the clean audio as clean-voice.mp3.name: rw-generate-audio description: "Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion." user-invocable: true allowed-tools: Read, Grep, Glob, Edit, Write, Bash(uv run *), Bash(command -v uv)
Generate Audio
Generate audio directly using the Runway API. Supports text-to-speech, sound effects, voice isolation, dubbing, and speech-to-speech voice conversion.
IMPORTANT: Run scripts from the user's working directory so output files are saved where the user expects.
Usage
uv run scripts/generate_audio.py --type tts --text "Hello world" --filename "greeting.mp3" [--voice-id ID] [--api-key KEY]
Preflight
command -v uvmust succeedRUNWAYML_API_SECRETmust be set, or pass--api-key
Audio Types
| Type | Description | Required Args |
|------|-------------|---------------|
| tts | Text to speech | --text |
| sfx | Sound effect generation | --text |
| isolate | Isolate voice from audio | --audio-url |
| dub | Dub to another language | --audio-url, --target-language |
| sts | Voice conversion | --audio-url |
Parameters
| Param | Description | Default |
|-------|-------------|---------|
| --type | Audio type (required): tts, sfx, isolate, dub, sts | -- |
| --filename | Output filename (required) | -- |
| --text | Text input (for tts and sfx) | -- |
| --audio-url | Audio URL or local path (for isolate, dub, sts) | -- |
| --voice-id | Voice preset (for tts and sts, e.g. Maya, Noah, Leslie) | Maya |
| --target-language | Language code (for dub, e.g. "es") | -- |
| --output-dir | Output directory | cwd |
| --api-key | Runway API key | env RUNWAYML_API_SECRET |
Examples
Text-to-speech:
uv run scripts/generate_audio.py --type tts --text "Welcome to our product showcase" --filename "voiceover.mp3"
Sound effect:
uv run scripts/generate_audio.py --type sfx --text "Thunder rolling across a stormy sky" --filename "thunder.mp3"
Voice isolation:
uv run scripts/generate_audio.py --type isolate --audio-url "noisy-recording.mp3" --filename "clean-voice.mp3"
Speech-to-speech (voice conversion):
uv run scripts/generate_audio.py --type sts --audio-url "recording.mp3" --voice-id Noah --filename "converted.mp3"
Dubbing:
uv run scripts/generate_audio.py --type dub --audio-url "english-narration.mp3" --target-language es --filename "spanish-dub.mp3"
Output
- The script downloads the result and saves it to the specified path
- Script outputs the full path to the saved file
Content Repurposer
Content
Transforms a single piece of content into platform-adapted publications.
SEO Blog Post Writer
Content
Writes SEO-optimized blog posts with proper structure and keywords.
YouTube Script Writer
Content
Writes engaging YouTube scripts with hooks, structure, and retention.