voice-clone
Record, test, and save a cloned voice to a brand profile
Install / Use
npx skills add digitalsamba/claude-code-video-toolkitInstalls into whichever agent you are using.
Claude Commands
Claude Code slash commands
Quality Score
Category
AutomationSupported Platforms
Our assessment of voice-clone
voice-clone scores 86/100 on our quality scale, 1769th of 2,769 Automation skills we index.
Its Claude Commands is 7.1 KB long, well organised into 11 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
With 2,544 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 5 days ago, so voice-clone is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
voice-clone compared with similar skills
All 4 of these similar skills score higher than voice-clone; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| voice-clone (this skill)by digitalsamba | 86 | 2.5k | 5d ago | Claude Commands |
| claude-memby thedotmack | 100 | 117.9k | today | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 117.6k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.0k | 2d ago | CLAUDE.md |
Frequently asked questions
- How do I install voice-clone?
- Run
npx skills add digitalsamba/claude-code-video-toolkit. The install tabs above show the steps for each supported agent. - Which AI agents does voice-clone work with?
- It is written for Claude Code, as a Claude Commands file. Other agents that read the same format can often use it too.
- Is voice-clone safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is voice-clone still maintained?
- The repository was last updated 5 days ago, so voice-clone is actively maintained.
Skill content
View source on GitHubdescription: Record, test, and save a cloned voice to a brand profile
Voice Clone
Guided workflow to set up Qwen3-TTS voice cloning for a brand. Records or imports reference audio, tests the clone, and saves the profile so --brand loads it automatically.
Step 1: Check Dependencies
Verify the environment is ready:
1. Check .env for RUNPOD_API_KEY
- If missing: "Add `RUNPOD_API_KEY=your_key` to `.env`"
2. Check .env for RUNPOD_QWEN3_TTS_ENDPOINT_ID
- If missing and API key exists: offer to run `uv run tools/qwen3_tts.py --setup`
- If API key also missing: guide user to add it first
3. Only proceed once both are confirmed
Use Grep to check .env for both keys. If the endpoint is missing but the API key exists, offer to run setup automatically.
Step 2: Choose Brand
Scan for available brands:
1. Glob brands/*/brand.json
2. For each brand, check if voice.json exists and has a qwen3.clone section
3. Present list:
Available brands:
1. default — no clone profile
2. digital-samba — clone configured (assets/voice-reference.m4a)
Which brand should this voice clone be saved to?
If the selected brand already has a clone profile, show the existing config and ask:
- Test existing clone — generate a sample to hear it
- Replace — record/import new reference audio
- Cancel — exit
Step 3: Record or Provide Reference Audio
Present a reference script for the user to read aloud. The script should be ~15-20 seconds and include varied intonation:
Suggested script to read aloud (~15 seconds):
"Welcome to this video walkthrough. Today we'll explore some exciting
new features — including improved performance, better accessibility,
and a redesigned dashboard. There's a lot to cover, so let's take it
step by step and get started!"
Options:
1. I'll record this script (provide the file path when ready)
2. I have my own audio sample
3. Use an existing file (enter path)
Read it at the pace you want the clone to narrate at. The clone inherits its speaking rate from the reference, and temperature/regeneration cannot correct pace afterwards — a short, snappy reference reliably produces rushed (170-210 wpm) narration on every take.
Once the user provides the audio file:
- Verify the file exists and is a supported format (wav, mp3, m4a, flac, ogg)
- Validate the reference before accepting it:
ffprobe -v error -show_entries format=duration -of csv=p=0 REFERENCE_FILE- Duration < 8s: warn strongly — too little prosody to anchor pace or tone; the clone will sound rushed and flat. Recommend re-recording.
- Duration 8-12s: usable, but suggest a longer take if convenient.
- Duration 12-25s: ideal.
- Also sanity-check content: fewer than ~25 words of varied, full-sentence speech (e.g. a repeated short phrase like "Thank you. Thank you.") gives the model no narration pacing to copy — warn and offer to proceed anyway.
- Copy it to
brands/{name}/assets/voice-reference.{ext} - Confirm the copy
Step 4: Transcript
Determine the transcript for the reference audio:
What was said in the recording?
1. I read the suggested script above (use that as transcript)
2. I'll type the exact transcript
If option 1: use the suggested script text. If option 2: ask the user to type or paste the exact words spoken.
The transcript must match what was actually said — this is critical for clone quality.
Step 5: Test the Clone
Generate a test clip using the reference audio:
uv run tools/qwen3_tts.py \
--text "This is a test of the cloned voice. It should sound natural and similar to the original recording." \
--ref-audio brands/{name}/assets/voice-reference.{ext} \
--ref-text "TRANSCRIPT_HERE" \
--output /tmp/voice-clone-test.mp3
After generation:
Clone test generated: /tmp/voice-clone-test.mp3
Listen to the result and let me know:
1. Sounds good — save this profile
2. Not quite right — re-record with different audio
3. Try with a different test phrase
4. Cancel
If the user wants to retry, go back to Step 3.
Step 6: Save to Brand
Before saving, ask about a default voice tone for this brand:
Would you like to set a default tone for this brand's Qwen3-TTS voice?
1. Neutral (no instruction)
2. Warm — friendly, conversational
3. Professional — clear, measured
4. Tutorial — patient, step-by-step
5. Custom instruction (type your own)
6. Skip — no default tone
If a tone is selected, save it in the tone field. If a custom instruction is provided, save it in the instruct field instead.
Update brands/{name}/voice.json to add/update the qwen3 section (including clone and tone):
{
"voiceId": "...",
"settings": { ... },
"qwen3": {
"speaker": "Ryan",
"language": "Auto",
"tone": "warm",
"instruct": "",
"clone": {
"refAudio": "assets/voice-reference.{ext}",
"refText": "Exact transcript of the reference audio."
}
}
}
Important:
refAudiopath is relative to the brand directorytoneis a named preset (e.g., "warm", "professional").instructis raw text override.instructtakes precedence overtone.- Preserve all existing fields in voice.json (ElevenLabs config, etc.)
- If no
qwen3section exists yet, create one with sensible defaults - If
qwen3exists but noclone, add just theclonesub-object
Step 7: Show Usage
Voice clone saved to: brands/{name}/voice.json
Usage:
# Per-scene voiceover with cloned voice
uv run tools/voiceover.py --provider qwen3 --brand {name} --scene-dir public/audio/scenes --json
# Single file
uv run tools/voiceover.py --provider qwen3 --brand {name} --script script.txt --output out.mp3
# In /generate-voiceover, select Qwen3-TTS — the clone profile will be detected automatically.
The clone profile is stored in brands/{name}/voice.json and will be loaded
automatically whenever you use --brand {name} with --provider qwen3.
Tool Locations
- Qwen3-TTS tool:
tools/qwen3_tts.py - Voiceover tool:
tools/voiceover.py - Brand voice config:
brands/{name}/voice.json - Reference audio:
brands/{name}/assets/voice-reference.{ext}
Voice Clone Tips
Share these with the user:
- Recording quality matters — use a quiet room, consistent mic distance
- 12-25 seconds of reference audio is ideal (too short = poor quality + rushed pace, too long = diminishing returns)
- The clone copies your pace — read the reference at narration speed; rushed or punchy references produce rushed clones, and no generation setting fixes it afterwards (use
--max-wpm 165on voiceover.py/qwen3_tts.py as a deterministic safety net) - Varied intonation helps — include questions, emphasis, and natural pauses; avoid repeating one short phrase
- Transcript accuracy is critical — must match the audio exactly
- Supported formats: wav, mp3, m4a, flac, ogg (wav or m4a preferred)
Integration
This command is referenced by:
/brand— Step 5 offers voice clone setup via/voice-clone/generate-voiceover— detects brand clone profiles when Qwen3-TTS is selected
Related Skills
claude-mem
117.9kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
taste-skill
117.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.0kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
