Communitygithub.com

poppatompong-dev/trilingual-subtitles-skill

タイ語、英語、簡体字中国語(または任意の言語)の字幕ファイル (.srt) を生成し、YouTube Shorts、TikTok、Reels にアップロードできるようにします。スクリプト、タイムスタンプ付きトランスクリプト、または既存のSRTから、自然な話し言葉に翻訳し、3つのファイルのタイミングを完全に同期させ、縦9:16画面に最適化し、可読性チェックを行います。

trilingual-subtitles-skill とは?

このスキルは、ショート動画向けの3ヶ国語対応のSRT字幕ファイル(タイ語、英語、中国語)を生成するためのものです。複数言語の字幕を同期させて提供することで、音声言語がわからない視聴者層にもリーチを広げられます。スクリプトからのタイミング推定、逐次翻訳、縦画面に最適化された改行、および可読性チェックを自動化し、手作業によるずれや翻訳の不自然さを防ぎます。主なワークフローは、タイムソースの取得(タイムスタンプ付きトランスクリプト、スクリプト+動画長、音声ファイルからの文字起こし)、行ごとの翻訳(短く自然な口語表現、句読点やフォーマットの統一)、JSON データの生成と `scripts/make_srt.py` による実行、そして品質チェック(1行あたりの文字数制限、読み取り速度、表示時間など)への対応です。出力は3つのSRTファイルとQCレポートで、必要に応じて手動調整を促します。このスキルは、ユーザーが「字幕」「サブ」「翻译」「字幕ファイル」を要求したときや、複数言語向けの動画を準備しているときに有効です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/poppatompong-dev/trilingual-subtitles-skill/tree/HEAD/skills/shorts-trilingual-srt

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

三カ国語 SRT ビルダー (TH / EN / ZH)

3つの言語で字幕が付いたショート動画は、音声言語がわからない視聴者にもリーチできます。しかし、質の低い字幕は逆効果です。タイミングのずれ、単語の途中で切れた行、機械翻訳のような不自然な文は、動画の質を下げます。このスキルは、完全に同じタイミング で、自然で、スマートフォン画面に収まる3つのSRTファイルを生成します。

バンドルされているスクリプト scripts/make_srt.py(Python標準ライブラリのみ使用)がファイルを書き出し、チェックを行います。コードを実行できる環境ではこれを使用してください。実行できない場合は、同じルールに従って手作業でSRTテキストを作成し、コードブロックで出力してください。

ステップ1 — タイムソースの取得

以下のうち、ユーザーが持っているものを特定し、優先順位の高いものから使用します。

  1. タイムスタンプ付きトランスクリプト(編集アプリからのSRT/VTT、YouTubeの自動キャプション、音声認識ツール)→ そのタイミングを使用。各キューの長さは1~3.5秒の意味のまとまりになるよう、結合または分割。
  2. 最終スクリプト + クリップの長さ → スクリプトをキュー(1つの発話フレーズ)に分割し、--estimate <seconds> でタイミングを推定。ユーザーには、推定タイミングは目安であり、実際の音声に合わせて編集ソフトで調整する必要があることを伝える。推定字幕は「字幕が合わない」原因の最も多いケース。
  3. 音声/動画ファイルのみ → セッション内で音声認識ツールが利用できる場合は、まず単語単位のタイムスタンプ付きで文字起こし。利用できない場合はその旨を伝え、ユーザーに編集アプリ(ほとんどの編集アプリやYouTube Studioでキャプションをエクスポート可能)からのトランスクリプト出力を依頼する。発話内容をでっち上げない。

ソース言語は発話通りに保持 — 音声と異なる字幕は視聴者を混乱させます。明らかな書き起こしミス(聞き間違い、ブランド名など)のみ修正し、修正した箇所をユーザーに伝える。

ステップ2 — 行ごとに翻訳

各キューを個別に翻訳し、すべての言語でタイミングを同一に保ちます。ルール:

  • 口語的で、短く、自然に。 字幕は1~2秒で読みます。「Turn it off at night」のように。「It is recommended that the device be switched off during night-time hours.」は避ける。
  • 単語よりも意味を優先。 タイ語のフィラー(นะครับ、เลย、อ่ะ)は英語/中国語では削除。イディオムは直訳ではなく相当する表現に。
  • 数字、単位、モデル名、アプリ名は3ファイルで同一 にし、同じ形式(例:80%、20W、iOS 26)で記述。タイ語の行の数字がすべて英語と中国語の行にも含まれているか確認。
  • 中国語 = 簡体字(zh-Hans) ユーザーが繁体字(zh-Hant、台湾/香港向け)を要求した場合を除く。全角句読点(,。?!)を使用。中国語の文字間にスペースを入れない。
  • メニューラベルと画面UIテキスト: その言語のアプリ/端末で実際に表示されるラベルを、知っている場合は使用。公式ラベルが不明な場合は説明的に翻訳し、ユーザーがその言語設定の端末で確認できるようにフラグを立てる。
  • 製品/ブランド名、地名、人名: 公式のローマ字表記を保持。ブランド名に公式の中国語名があると確信できない限り、中国語に翻訳しない。
  • 音声に含まれない情報、ジョーク、絵文字を追加しない。

ステップ3 — JSONを書いてスクリプトを実行

{
  "langs": ["th", "en", "zh-Hans"],
  "segments": [
    {"start": 0.0, "end": 2.6, "th": "ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม?", "en": "Does charging overnight ruin your battery?", "zh-Hans": "整夜充电会伤电池吗?"},
    {"start": 2.7, "end": 6.1, "th": "คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ", "en": "Short answer: not instantly, but heat is the real enemy.", "zh-Hans": "简单说:不会马上坏,但真正的敌人是热量。"}
  ]
}
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01
# タイミング未設定の場合:
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01 --estimate 38.5

出力: subs/clip01.th.srt, subs/clip01.en.srt, subs/clip01.zh-Hans.srt およびQCレポート。

改行: スクリプトは長いキューを2行に折り返します。タイ語は単語間にスペースがないため、タイ語書き手が句の間に入れるスペースでのみ改行 — 単語を途中で分割することはありません。タイ語のキューが長すぎる場合、句の間にスペースを入れるか、|(スペース-パイプ-スペース)で強制改行を入れます。例: "เปิดโหมดชาร์จ | แบบปรับให้เหมาะสม"

ステップ4 — QCメッセージをすべて修正

スクリプトは言語ごとに以下をチェックします:

チェック項目デフォルト制限理由
1行あたりの文字数TH 24 · EN 38 · ZH 15縦画面; 長すぎる行はいいね/コメントボタンの下に隠れる
キューあたりの行数23行だと画面を覆いすぎる
読み取り速度 (文字/秒)TH 17 · EN 20 · ZH 9これを超えると視聴者が読み終えられない
画面表示時間≥ 0.7 秒フラッシュは読めない
重複 / 終了が開始より前 / 空のテキスト許可しないプラットフォームが拒否または誤表示する

修正は、翻訳を短くする(第一選択)、長いキューを2つに分割する、またはフラッシュのような短いキューを隣のキューに統合する。エラーが0になるまで再実行。数件の警告は、内容をユーザーに伝えれば許容。制限は --max-line と --max-cps で変更可能。

タイ語の文字カウントは、上または下に付く母音記号や声調記号を無視します(画面表示上の幅を取らないため)。

ステップ5 — 引き渡し

ユーザーに以下を提供:

  1. 3つの .srt ファイル(ファイル作成が不可能な場合はコードブロック内の内容)。
  2. 確信が持てなかった行(UIラベル、スラング、名前など)の短い一覧表(ユーザーが確認できるように)。
  3. 使用方法:
    • YouTube Studio: 字幕 → 該当動画を選択 → 言語を追加 → ファイルをアップロード → 「タイミング付き」。言語ごとに1ファイルずつアップロード。まず動画の元の言語を設定すること。
    • 埋め込み字幕(動画に直接描画): ほとんどのショート動画視聴者は音声なしで視聴するため、主要言語を動画に焼き付け、他の言語をSRTとしてアップロードするのは一般的な方法。多くの編集ソフトはSRTをインポートしてスタイル設定可能。
    • TikTok / Reels: SRTファイルのアップロード対応はアプリのバージョンや地域によって異なる — アップロードオプションがない場合は、編集ソフトで字幕を動画に焼き付ける。プラットフォームの最新ヘルプページを確認すること。

例

ユーザー: 「ทำซับ 3 ภาษาให้หน่อย คลิป 9 วิ」 + スクリプト:

ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม? / คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ / เปิดโหมดชาร์จแบบปรับให้เหมาะสม ในตั้งค่าแบตเตอรี่

あなたの対応: 3つのキュー → 翻訳 → --estimate 9 で実行 → QCがタイ語のキュー3の行が26文字(เปิดโหมดชาร์จแบบปรับให้เหมาะสม、制限24)と警告。強制改行はここでは役に立たない(2行目が長くなりすぎる)ので、代わりに字幕を短縮: "เปิดโหมดถนอมแบต ในตั้งค่าแบตเตอรี่"。字幕は発話より少し短くても、意味が同じであれば問題ありません。ユーザーのスタイルが逐語訳を好む場合は、短縮前に確認を取る。再実行: エラー0、警告1(タイミング推定)。3つのファイルを提供し、「タイミングはテキスト長から推定されています — エディターで音声に合わせて調整してください。バッテリー設定の英語/中国語名を、その言語設定の端末で確認してください」と伝える。

clip01.th.srt の結果:

1
00:00:00,000 --> 00:00:02,653
ชาร์จมือถือข้ามคืน
แบตเสื่อมจริงไหม?

2
00:00:02,653 --> 00:00:06,347
คำตอบสั้น ๆ คือ ไม่ได้พังทันที
แต่ความร้อนคือตัวการ

3
00:00:06,347 --> 00:00:09,000
เปิดโหมดถนอมแบต
ในตั้งค่าแบตเตอรี่

関連スキル