RTY2345RR/miragea-agent-skills / skills/youtube-dubbing
youtube-dubbing
VerifiedYouTube dubbing skill for Claude Code, Codex and Cursor: dub a YouTube or local video into another language while each speaker keeps a cloned version of their own voice, with synced SRT captions and a ready-to-upload multi-language audio package, through the youtube-dubbing-mcp MCP server. Use when the user asks to dub a YouTube video, AI dub an interview or podcast, translate a video's audio, add a multi-language audio track, or clone speakers' voices in another language.
YouTube video dubbing with per-speaker voice cloning
Turn a video into a dubbed audio track plus captions in a new language. Each speaker keeps a cloned version of their own voice. Voice cloning and synthesis run on the Miragea engine inside the dubbing_* MCP tools; never substitute another TTS.
0. Preconditions
- The
dubbing_*tools must exist. If not, tell the user:claude mcp add youtube-dubbing -s user -e MIRAGEA_API_KEY=<key> -- uvx --from git+https://github.com/RTY2345RR/youtube-dubbing-mcp youtube-dubbing-mcp. Keys: https://miragea.ai/workspace/api. Never ask for the key in chat. - Call
dubbing_check_setupfirst and fix anything it reports (ffmpeg, key). - YouTube's public API cannot upload extra audio tracks, so the result is a package the user uploads in YouTube Studio. Do not promise auto-upload.
1. Brief
Ask only what is missing: source video (file path or URL the user owns or may dub), target language, and whether the speakers should keep their own voices (default yes).
2. Workflow
dubbing_start_projectwith the video and target language. It transcribes and splits sentences.dubbing_get_segments; check the transcript with the user if it looks wrong. Fix speakers withdubbing_assign_speakers(one label per real person).dubbing_extract_voice_samplesto cut a clean reference clip per speaker, thendubbing_set_voiceper speaker (cloned sample, or a voice fromdubbing_list_voicesif the clip is too noisy or short).- Translate each segment yourself and send it with
dubbing_set_translation. Keep each line close to the original duration: short, spoken phrasing, numbers written out, no markup. dubbing_render(long jobs resume: re-run the same call, never start a duplicate project). Usedubbing_project_statusto follow progress.dubbing_export_youtube_packageto get the dub audio, SRT captions, optional muxed MP4 and upload steps.- Report the file paths and the Studio steps (Subtitles → add language; Audio → add dub track).
3. Quality checks
- Listen for lines that overrun the original timing; shorten the translation and re-render only those segments.
- Each speaker must keep a distinct voice; if two sound alike, pick a different sample.
- Only dub content the user has rights to.
Example
See examples/ (two speakers, one male and one female, dubbed into English with cloned voices: dub.en.mp3, dub.en.srt, dubbed-interview-en.mp4).
Troubleshooting
synthesis_failedon a cloned voice: the reference URL must be publicly fetchable; the tools upload samples for you, retry once.- Missing ffmpeg: install it and rerun
dubbing_check_setup.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |