video-translation — Claude Code skill: dub videos with TTS
Translates speech in a video into another language and swaps the audio track for synthesized voice, leaving the picture untouched.
npx skills add NoizAI/skills --skill video-translation -a claude-codeWhat video-translation does
The skill takes a video URL, downloads the file with its subtitles as SRT, translates the lines sentence by sentence and renders a new track through TTS. The video itself stays as it was — only the audio changes.
It leans on two other skills. youtube-downloader fetches the video and subtitles in the source language, tts renders audio against the subtitle timestamps, and the Noiz backend stretches each sentence to fit the original cue. Pass the source file to --ref-audio-track and the engine slices the original audio at every timestamp, using those clips as the voice reference for that segment. The last step is replace_audio.sh, which merges video and dubbed audio; the --srt flag keeps the background sound between translated segments intact.
You need a NOIZ_API_KEY for the Noiz backend and ffmpeg on the machine. The youtube-downloader and tts skills have to sit in your skills/ folder — copy them in yourself if they are not there yet. One catch worth knowing before you start: the source video must have subtitles in the original language, auto-generated ones included. Without them there is nothing to translate and the pipeline stops at step one.
What it helps with
- translate speech in a foreign video into your own language
- generate a dub that keeps the subtitle timestamps
- swap the audio track without re-encoding the video
- keep background sound outside the translated segments
- clone the speaker's voice from the original track
Example prompts for the agent
- translate this video to English
- dub this video to Spanish
- translate the video at this link and replace the audio
How to install video-translation
1Skills CLI (Vercel)
npx skills add NoizAI/skills --skill video-translation -a claude-code2Manually: put the files in place
~/.claude/skills/video-translation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/video-translation/
1Skills CLI (Vercel)
npx skills add NoizAI/skills --skill video-translation -a codex2Manually: put the files in place
.agents/skills/video-translation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NoizAI/skills --skill video-translation -a cursor2Manually: put the files in place
.cursor/skills/video-translation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NoizAI/skills video-translation2Manually: put the files in place
.github/skills/video-translation/SKILL.md1Skills CLI (Vercel)
npx skills add NoizAI/skills --skill video-translation -a gemini-cli2Platform CLI
gemini skills install https://github.com/NoizAI/skills --path skills/video-translationManually: put the files in place
.devin/skills/video-translation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NoizAI/skills --skill video-translation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about video-translation
How do I install video-translation in Claude?
Run npx skills add NoizAI/skills --skill video-translation -a claude-code. The skill then lands at ~/.claude/skills/video-translation/SKILL.md.
What does video-translation do?
It downloads a video with its subtitles, translates the lines into the target language and synthesizes a new audio track with TTS. The video stream is left alone.
What do I need before running it?
A NOIZ_API_KEY for the Noiz backend, ffmpeg installed, and the youtube-downloader and tts skills in your skills/ folder. The source video also needs subtitles in its original language.
