# Protoss Voice

> Generate Protoss-style (StarCraft) voice effects using SoX and FFmpeg.

- Skill: `kbarbel640-del/protoss-voice` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/protoss-voice`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/protoss-voice/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/protoss-voice

---


# Protoss Voice Effect

Applies a "Khala" psionic transformation chain to audio files using the V9 "Massive Void" engine.

## Usage

Run the script on any audio file:

```bash
python3 skills/protoss-voice/protoss_fx.py <path_to_audio_file>
```

**Example:**
```bash
python3 skills/protoss-voice/protoss_fx.py recordings/my_voice.mp3
```

Files are saved as `*_psionic.mp3` in the source directory.

## Algorithm

The current architecture prioritizes a massive, distinctive spatial presence.

1. **Shadow Generation:** Pitch shift (-2 semitones) + Time stretch (0.9x).
2. **Void Layer:** Reverse -> Dense Reverb -> Reverse (creates "pre-verb" suction).
3. **Mastering:** Original voice is discarded. Bass boosted (+5dB), Subsonics cut (<100Hz).

## Integration Workflows

### ElevenLabs Post-Processing
This skill is designed to be used as a post-processing step for TTS generation.
When generating voice content to mimic "Selendis" or other Protoss personas:

1. **Generate:** Create raw speech using ElevenLabs.
2. **Process:** Pass the output file immediately through `protoss_fx.py`.
3. **Result:** Use the resulting `_psionic.mp3` file as the final asset.

## Requirements

Requires `ffmpeg` and `sox` (Sound eXchange).

```bash
brew install ffmpeg sox
```

## Agent Protocol

When a user requests audio or voice interaction involving a Protoss persona:

1.  **Generate Raw Audio:** Use the `tts` tool to generate the base speech file.
2.  **Silence:** Do NOT present the output path from the `tts` tool to the user yet.
3.  **Process:** Execute the python script on the raw file:
    `python3 skills/protoss-voice/protoss_fx.py <path_from_tts>`
4.  **Deliver:** Use the `message` tool to send the file explicitly (more reliable than text echo):
    `message(action="send", filePath="<path_from_script>", asVoice=true)`