impressions

Clone custom voices for VoiceMode TTS using local mlx-audio and reference audio clips.

1.3k|189|Updated Jun 8, 2025
One-click install
npx skills add https://github.com/mbailey/voicemode --skill impressions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: impressions
Source: https://github.com/mbailey/voicemode/tree/main/.claude/skills/impressions
Command: npx skills add https://github.com/mbailey/voicemode --skill impressions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-audio, ffmpeg, and includes references (resource) components.

What problem does it solve?

VoiceMode's built-in Kokoro and OpenAI voices are fixed; this Skill lets you make VoiceMode speak in any voice by cloning it from a short reference audio clip using local Qwen3-TTS on mlx-audio.

Core Features & Use Cases

  • Voice Cloning from Reference Clips: Add a custom voice from a 3-9 second audio sample with voicemode clone add, then use it via voicemode converse --voice <name> or the MCP converse tool.
  • Clip Validation and Normalization: Automatically validates clip duration, normalizes audio to mono 24 kHz 16-bit PCM with EBU R128 loudnorm, and auto-transcribes the reference into a voice.md profile.
  • Local and Remote mlx-audio Support: Runs Qwen3-TTS locally on Apple Silicon or routes requests to a remote mlx-audio server with path translation via VOICEMODE_REMOTE_VOICES_DIR.
  • Use Case: You want Claude to respond in a specific person's voice during a voice conversation. Install the mlx-audio service, add a clean 7-second clip of that speaker, and pass voice="fleabag" to converse.

Quick Start

Ask the assistant to install the mlx-audio service and clone a voice from a short reference clip so VoiceMode can speak in that voice during conversations.

Frequently Asked Questions about impressions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clone a voice for VoiceMode TTS?

Install the mlx-audio service with `voicemode service install mlx-audio`, then run `voicemode clone add <name> <clip.wav>` with a 3-9 second reference clip. Use the voice by passing `voice="<name>"` to the converse tool.

What makes a good reference clip for voice cloning?

Use 5-9 seconds of clean, conversational speech from a single speaker with no music, cross-talk, or background noise. Always pair the clip with an accurate transcript, since a missing transcript causes stammered synthesis.

Does VoiceMode voice cloning work on Intel Macs or Linux?

No, the mlx-audio service is Apple Silicon only and refuses to install on Intel Macs, Linux, or Windows. On those platforms, use cloud TTS providers like OpenAI or point VoiceMode at a remote Apple Silicon mlx-audio server.

Why does my cloned voice stammer or stutter during synthesis?

Stammering happens when the reference clip lacks a transcript, forcing the model to transcribe the audio itself and mis-hear it. Fix it by adding a corrected transcript in `voice.md`, a `<clip>.txt` file, or the `ref_text` parameter in converse.

Why does my custom voice fall back to Kokoro instead of cloning?

The voice profile is not being recognized. Check that `~/.voicemode/voices/<name>/default.wav` exists and that the name does not collide with a built-in Kokoro voice like `af_sky`, which shadows the custom profile.

How do I use a remote mlx-audio server for voice cloning?

Set `VOICEMODE_MLX_AUDIO_BASE_URL` to the remote server's URL and `VOICEMODE_REMOTE_VOICES_DIR` to the voices path as seen by that server. VoiceMode rewrites reference audio paths so the remote host can resolve them on its own filesystem.