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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| examples/dub.en.mp3 | binary | 177.9 KB |
| examples/dub.en.speakers.srt | other | 260 B |
| examples/dub.en.srt | other | 236 B |
| examples/dubbed-interview-en.mp4 | binary | 199.3 KB |
SKILL.md
View on GitHub---
name: youtube-dubbing
description: "YouTube 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."
license: MIT
metadata:
version: "0.1.0"
requires: "youtube-dubbing-mcp MCP server (uvx --from git+https://github.com/RTY2345RR/youtube-dubbing-mcp youtube-dubbing-mcp) and a MIRAGEA_API_KEY"
keywords: "youtube dubbing, ai video dubbing, claude code youtube skill, multi-language audio, voice cloning"
---
# 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_setup` first 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
1. `dubbing_start_project` with the video and target language. It transcribes and splits sentences.
2. `dubbing_get_segments`; check the transcript with the user if it looks wrong. Fix speakers with `dubbing_assign_speakers` (one label per real person).
3. `dubbing_extract_voice_samples` to cut a clean reference clip per speaker, then `dubbing_set_voice` per speaker (cloned sample, or a voice from `dubbing_list_voices` if the clip is too noisy or short).
4. 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.
5. `dubbing_render` (long jobs resume: re-run the same call, never start a duplicate project). Use `dubbing_project_status` to follow progress.
6. `dubbing_export_youtube_package` to get the dub audio, SRT captions, optional muxed MP4 and upload steps.
7. 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_failed` on 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: 323k | 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: 323k | 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: 323k | Updated | Claude CodeCodex | Verified | Install |