SoulDub Video Translate Skill

この Skill は Agent の次の操作を支援します。

• ローカルの .mp4 動画を SoulDub にアップロードする。
• 動画翻訳タスクを作成する。
• 長時間の翻訳処理の進捗を追跡する。
• 翻訳動画と字幕をダウンロードする。

成功すると次のファイルが保存されます。

• result.mp4: 翻訳動画
• translated.srt: 対象言語の字幕
• bilingual.srt: バイリンガル字幕

公開 GitHub リポジトリからインストールします。

npx skills add jiabaogithub/souldub-skills --skill souldub-video-translate

インストール後、ローカル MP4 のパスと対象言語を指定して Agent に Skill を実行させます。

Use the souldub-video-translate skill to translate C:\path\to\video.mp4 into Japanese.

この Skill は Japanese、Chinese、日语、中文、粤语 など、対応している言語名も受け付けます。

Agent は不足している情報を確認し、翻訳を開始し、進捗を報告し、完了後にローカルの出力パスを返します。

この Skill には SoulDub API キーが必要です。

インストール後、Agent に認証状態を確認させます。

uv run scripts/video_translation.py auth status

API キーが設定されていない場合、Skill は次のユーザーレベル設定ファイルを作成します。

~/.souldub/souldub.config.yaml

ファイルに souldub_api_key を設定するか、SOULDUB_API_KEY 環境変数を設定してください。

• Python 3.11+
• uv
• SoulDub Agent API へのネットワークアクセス
• SoulDub API キー
• 入力 MP4 ファイルの読み取り権限
• 出力先の書き込み権限

インストール済みの Skill ファイルは読み取り専用として扱われます。

実行状態はユーザーのプラットフォーム状態ディレクトリに保存されます。翻訳結果は入力動画の隣にある souldub_outputs/ に保存されます。

Skill は API キー、アップロード用署名 URL、メディアゲートウェイ URL、または一時署名パラメータを永続化しません。

リポジトリ構成:

skills/
└── souldub-video-translate/

リポジトリのルートからローカル検出を確認します。

npx skills add . --list

ローカル作業コピーをインストールします。

npx skills add . --skill souldub-video-translate

ヘルパーを直接実行してローカルデバッグします。

cd skills/souldub-video-translate
uv run scripts/video_translation.py auth status