できること
Open-source Video Translation Skill
作者による原文
- 接続方法 AI が読む指示ファイルで、外部サービスを呼び出す手順を含みます
- アカウントまたはキー TOGETHER_API_KEY, OpenAI, ElevenLabs のキーが必要な手順があります(README より)
- カテゴリ 自動化とエージェント
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/skills/shang-zhu-violin)似た Skill
同じ種類の作業。Skill 一覧と同じ並び
shang-zhu による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません
Skill と MCP の違い
MCP = 手
AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。
Skill = 手順書
作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。
重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。
使えるアプリ
Claude Code
提供元の README と repo のフォルダから判断
インストール
安全ですか?
- 作った人
GitHub アカウント shang-zhu(個人)、作成から 6 年
- 利用状況と更新
★ 1,090 スター · コードの最終更新 2026年9月4日
- スクリプトはありますか?
ありません。テキストファイルのみで、AI が読んで従います
- インターネットを使いますか?
スクリプトがないので、自分から通信することはありません
- パソコン全体の設定を変更しますか?
hook やパソコンの設定への書き込みは見つかりませんでした
リポジトリの commit 7a86852 のファイルから自動でチェックしました(読み取りのみで、何も実行していません)。安全の保証ではありません。ご自身で読んで判断してください
まず:どの AI を使っていますか
使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます
方法 1claude.ai にアップロード(Web とアプリ)
説明文が 200 文字を超えているため(463 文字)、claude.ai にはアップロードできません。代わりに「AI にインストールしてもらう」を使ってください
方法 1Claude Code にインストールしてもらう
この文をコピーして Claude Code のチャットに貼り付けます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Claude Code を開き直し、/video-translator と入力するか関連する作業を頼むと Claude が自動で使います
Checked against official docs 2026年11月12日 · Source: code.claude.com
Terminal を使う方へ
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.claude/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
Claude Code を開き直し、/video-translator と入力するか関連する作業を頼むと Claude が自動で使います
ChatGPT デスクトップアプリ
ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます
方法 1ChatGPT にインストールしてもらう
ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます
インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
方法 2自分でフォルダを置く
video-translator フォルダを ~/.agents/skills/video-translator に置きます
~ はホームフォルダ($HOME)です
Terminal を使う方へ
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.agents/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
インストールしたあと
- ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
- 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
- Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Web 版とモバイル版の ChatGPT
自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます
この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
方法 1Codex にインストールしてもらう
この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Terminal を使う方へ
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.agents/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
Codex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します
方法 1Cursor にインストールしてもらう
この文をコピーして Cursor のチャットに貼り付けます
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Cursor の Agent チャットで / を入力し video-translator を選ぶ
Checked against official docs 2026年11月12日 · Source: cursor.com
Terminal を使う方へ
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.cursor/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
Cursor の Agent チャットで / を入力し video-translator を選ぶ
方法 1AI にインストールしてもらう
Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · この文章をコピーして、アプリのチャットに貼り付けてください
1 つのプロジェクトだけに入れる場合は、そのプロジェクトのフォルダで開いているチャットに貼り付けてください · インストールの前に、AI が必ずパスを見せます
AI は先に何をするか説明し、各ステップで許可を求めます
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Terminal を使う方へ
Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。
2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認
元の SKILL.md を見る
以下は提供元の repo の文章で、PopNx MCP の指示ではありません
4,143 文字 · GitHub で全文を開く
---
name: video-translator
description: Dub a video into another language and generate subtitles using the default Together + Cartesia stack. Trigger when the user wants to translate / dub / voice-over a video file, or generate subtitles for it. Handles `.mp4` / `.mkv` / `.webm`. Installs as the `violin` CLI (and `violin-api` for the FastAPI server) via `uv tool install`. For alternative models (OpenAI / ElevenLabs) or custom configs, point the user to the repo: https://github.com/shang-zhu/violin.
allowed-tools: Bash, Read
---
# Violin — operating skill
Always uses the default config (Together for translation, `cartesia/sonic-3` for TTS). If the user asks for OpenAI, ElevenLabs, or custom configs, **stop and point them to the Violin repo** — those flows aren't supported through the global CLI.
## Pre-flight
Run these silently first. Abort if any fails:
```bash
command -v violin # 1. CLI on PATH
test -f "<input>" # 2. Input exists
printenv TOGETHER_API_KEY # 3. Key available
```
If `violin` is missing: tell the user to `uv tool install violin`, then `violin --install-skill` to refresh this skill file. Do not auto-install.
If `TOGETHER_API_KEY` is missing:
- Inside the Violin repo → populate `.env` (auto-loaded)
- Elsewhere → `export TOGETHER_API_KEY=...` in `~/.zshrc` / `~/.bashrc`, then `source` it
## Decisions
- **CLI vs API**: single run-and-wait file → CLI (`violin`). Multi-job / HTTP / web UI → API server (`violin-api`); print the command, don't auto-start it.
- **Style** (`--style`): default `standard`. Kids content → `kids`, formal/lecture → `academic`, casual → `casual`, dramatic → `storyteller`, news → `news`. Run `violin --style list` if unsure.
- **Voiceover**: keep default (mix dubbed audio over a quiet original). Use `--no-voiceover` only when the user explicitly says "replace audio entirely".
## Run
```bash
violin <input> <output> --language <Lang> [flags]
```
## Flags
| Flag | Default | When to set |
|------|---------|-------------|
| `--language` / `-l` | *required* | Target language (e.g. `Chinese`, `Spanish`, `Japanese`). |
| `--voice` / `-v` | auto (native voice picked by `preferences.voice_gender`) | Only when the user names a specific voice from the catalog (e.g. `"warm female narrator"`). Otherwise omit and let the default kick in. |
| `--source-language` | `auto-detect` | Only if Whisper mis-detects the source language. |
| `--style` / `-s` | `standard` | See Decisions above. |
| `--no-subtitles` | off | User says "no SRT" / "video only". |
| `--no-voiceover` | off | User says "replace original audio entirely". |
| `--config` / `-c` | `config/default.yaml` | Don't use through this skill — repo-only flow. |
| `--timings-out` | off | Only when the user wants a per-step timing JSON for debugging / benchmarking. |
## Language coverage
33 target languages total. **16** ship with handpicked native-speaker voices: Chinese, Spanish, English, Hindi, Arabic, Portuguese, Russian, Japanese, Turkish, German, Korean, French, Italian, Polish, Dutch, Swedish. The other **17** fall back to the English voice catalog (multilingual under Cartesia Sonic 3) — quality is decent but the voice isn't a native speaker. Mention this caveat only if the user is translating to a fallback language and asks about voice quality.
## Report back
- Output video path + SRT path (printed by the run).
- Total cost (printed at end — surface, don't hide).
- If voiceover was on, mention the `_original.m4a` sidecar.
## Don'ts
- Don't run on multi-GB videos without first quoting the rough cost (audio length × per-provider rates in `pipeline/pricing.py`).
- Don't fabricate a "subtitles-only" mode — the CLI requires the full pipeline. If the user only wants SRT, run the full pipeline and hand them just the `.srt`, warning them of the cost first.
- Don't try to switch to OpenAI or ElevenLabs from this skill. Point the user to the repo + `--config config/other_api.yaml` (or their own override).
- Don't paraphrase the README. For supported languages (33), voice catalog, and full flag docs, point them at `README.md` or `violin --help`.
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
GitHub の情報
- GitHub スター
- 1,090
- 提供元
- shang-zhu
- ライセンス
- MIT
- 最終コード更新
- 2026年9月4日
- repo 内の SKILL.md(翻訳版とテンプレートを含む)
- 1
- トピック
- agent-skills, asr, dubbing, video-translation
- Repo
- shang-zhu/violin