runwayml/rw-generate-audio
skills/rw-generate-audio/SKILL.md
Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.
$ install --global
skillsauthnpx skillsauth add runwayml/skills rw-generate-audioInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 7:43 AM5.1s1 file scanned
SKILL.md
- 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
Related Skills
runwayml/use-runway-api
development
VerifiedTrustedCommunity
Directly use the Runway API from the agent to generate media, manage resources, and inspect account state
22SKILL.mdUpdated Apr 17, 2026
runwayml/rw-setup-api-key
development
VerifiedTrustedCommunity
Guide users through obtaining and configuring a Runway API key
22SKILL.mdUpdated Apr 17, 2026
runwayml/rw-recipe-full-setup
development
VerifiedTrustedCommunity
Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints
22SKILL.mdUpdated Apr 17, 2026
runwayml/rw-integrate-video
development
VerifiedTrustedCommunity
Help users integrate Runway video generation APIs (text-to-video, image-to-video, video-to-video)
22SKILL.mdUpdated Apr 17, 2026