---
name: elevenlabs-sfx
description: Generate sound effects from text descriptions using ElevenLabs. Control duration, looping, and prompt influence.
---

# ElevenLabs Sound Effects

Generate high-quality sound effects from text descriptions.

## Prerequisites

- **ELEVENLABS_API_KEY** environment variable set

## Command

```bash
/root/clawd/skills/elevenlabs-sfx/scripts/sfx.sh "description" [output_file] [duration_seconds] [prompt_influence]
```

## Examples

```bash
/root/clawd/skills/elevenlabs-sfx/scripts/sfx.sh "thunder crack with distant rumbling"
/root/clawd/skills/elevenlabs-sfx/scripts/sfx.sh "coffee shop background ambience" cafe.mp3 10
/root/clawd/skills/elevenlabs-sfx/scripts/sfx.sh "sword clash metallic ring" sword.mp3 2 0.7
/root/clawd/skills/elevenlabs-sfx/scripts/sfx.sh "gentle rain on a rooftop" rain.mp3 15
```

## Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| description | required | Text describing the sound |
| output_file | `/tmp/elevenlabs_sfx_output.mp3` | Where to save the audio |
| duration_seconds | auto | 0.5–30 seconds |
| prompt_influence | `0.3` | How closely to follow the prompt (0–1) |

## Tips for good prompts

- Be specific: "metallic door hinge creak" > "creak"
- Add context: "sci-fi laser gun fire in a large hall"
- Include texture: "crunchy gravel footsteps on a wet path"
- Higher `prompt_influence` (0.6–1.0) sticks closer to the description

## When to use

- User needs a sound effect for a video or project
- Creating ambient audio for a scene
- Generating UI sounds or notification tones