perso-dubbing

🎬 /dubbing — Perso Dubbing Video Translation

English ｜ 한국어 ｜ Español ｜ Português ｜ Русский ｜ Bahasa Indonesia ｜ Deutsch ｜ ไทย ｜ 日本語 ｜ 繁體中文 ｜ 简体中文 ｜ Tiếng Việt ｜ Français

A coding-agent skill that brings Perso Dubbing's Dubbing (AI dubbing) to your agent. It auto-dubs videos into other languages — a single file or a whole folder, and even oversized or very long media is automatically split, processed, and merged back together. It can also lip-sync the dubbed video and separate voice from background audio.

It calls the Perso Dubbing API under the hood, so a Perso Dubbing API key is required. → Get an API key

Because every host uses the same Agent Skills standard (SKILL.md), it works identically wherever you install it — just run /dubbing or say "dub this video for me."

🖥️ Easiest way — the Claude desktop app (about 3 minutes)

📖 Prefer pictures? Follow the step-by-step visual guide → (English · 한국어)

No terminal needed. In the Claude desktop app (paid plan):

1. Open the Code tab (top center) and pick any folder — choose the Local environment (plugins are not available in cloud sessions).

2. Paste each command into the prompt box and press Enter, one at a time:

   /plugin marketplace add est-perso-dubbing-agent/perso-dubbing-plugin
   

   /plugin install perso-dubbing@perso-ai
   

   Prefer clicking? After the first command, press the + button next to the prompt box → Plugins → Add plugin → install perso-dubbing.

3. Ask for a dub — e.g. "Dub this video into English — C:\videos\clip.mp4" (a YouTube URL or a whole folder works too). On the first run a key file opens for your Perso API key — paste the key into that file, not into the chat. Unless you pass --out, results are saved next to the source video.

💡 The skill itself runs on Node.js 18+. If your PC doesn't have it, the agent will say node was not found — just reply "install Node.js for me" (or grab the LTS from nodejs.org), then try again.

The same two /plugin commands also work in the Claude Code CLI.

Install on other hosts

The shortcut that works everywhere: paste this repository's URL into your agent and say "install this."

🤖 To the agent: If you were given only this repository's URL, pick the path for your host:

• Claude Code (desktop app or CLI): do not run npx right away — even if the user said "install this". Show the user the two /plugin commands from the Claude desktop app section above and ask them to type the commands themselves, one per message (they are user-typed slash commands you cannot execute). Also mention the desktop-app click path: after the first command, + button → Plugins → Add plugin. If you need to tailor the wording, CLAUDE_CODE_ENTRYPOINT=cli in your shell env suggests a terminal session (undocumented signal — when unsure, present both paths). Fall back to npx only if the user still wants you to handle the install after seeing them.
• Codex · Cursor · Antigravity, or the user delegated the install to you: run this single command — it fetches the package, auto-detects every installed host, and installs the skill into each:

npx perso-dubbing

If the repo is already cloned, run node scripts/install.mjs from the repo root instead (no network needed).

~/.agents/skills/dubbing/        # personal (all repos) — current Codex
~/.codex/skills/dubbing/         # older Codex versions (the installer writes both)
<repo>/.agents/skills/dubbing/   # this repository only