video-subtitle-toolkit の日本語概要

Tool
video-subtitle-toolkit の日本語概要

video-subtitle-toolkit の日本語概要

YouTube や X（旧 Twitter）から動画をダウンロードし、韓国語・英語の二言語字幕を自動生成して映像に焼き付けるワークフロースキルです。Claude、Codex、VS Code など複数の AI 開発ツールからネイティブに呼び出せる SKILL.md を備え、Agent Skills Open Standard に基づく互換性を目指しています。動画取得→音声抽出→文字起こし→翻訳→タイムスタンプ整形→映像への焼き付けという流れで、スキルとして自動化・統合できる点が特徴です（約300字）。

https://github.com/binnu-dev/video-subtitle-toolkit

概要

video-subtitle-toolkit は、YouTube と X（旧 Twitter）の動画を取得し、韓国語（한글）と英語の二言語字幕を自動生成して動画に焼き付け（burn-in）るためのツールキットです。リポジトリには SKILL.md が含まれており、Agent Skills Open Standard に準拠することで Claude、Codex、VS Code をはじめ 14 以上の AI コーディングツールからネイティブに実行できる「スキル」として設計されています。ワークフローはダウンロード→音声抽出→自動文字起こし→翻訳・整形→映像への字幕合成という一般的な流れを想定しており、動画コンテンツの多言語化と配信向けの字幕焼き付けを効率化します。

GitHub

リポジトリの統計情報

  • スター数: 7
  • フォーク数: 2
  • ウォッチャー数: 7
  • コミット数: 2
  • ファイル数: 7
  • メインの言語: Python

主な特徴

  • YouTube / X(Twitter) の動画をダウンロードして処理するワークフローを提供
  • 韓国語と英語の二言語字幕を自動生成し、動画に焼き付け（burn-in）可能
  • SKILL.md による Agent Skills Open Standard 準拠で Claude、Codex、VS Code 等と連携
  • 14 以上の AI コーディングツールでネイティブに動作する設計を目指す

技術的なポイント

このツールキットは「スキル（Skill）」という形で設計されている点が特徴です。SKILL.md は Agent Skills Open Standard をベースにしており、スキル仕様を用いることで多様な AI 開発環境から共通インターフェースで呼び出せます。実際の字幕生成ワークフローは次のような段階で構成されることが想定されます：1) 動画のダウンロード（YouTube / X の URL から映像と音声を取得）、2) 音声の抽出と自動文字起こし（STT）、3) 元言語の整形とタイムスタンプ化、4) 翻訳（韓国語 ↔ 英語）による二言語字幕生成、5) 字幕フォーマット（SRT 等）への変換と最終的な焼き付け（FFmpeg 等によるオーバーレイ）。実装言語は Python がメインで、package.json が含まれている点からフロントエンドやスキル配布に npm 系の設定が混在している可能性があります。リポジトリ内の docs と evals ディレクトリはドキュメントと評価用のノートやサンプルを含む想定で、運用時の検証やツール間の連携テストに使われるでしょう。

重要な設計上の配慮として、字幕の品質は音声認識（STT）と翻訳モデルの性能に依存します。そのため実運用では Whisper 系やクラウドの音声認識 API、機械翻訳（商用 API や大規模言語モデルの翻訳機能）を組み合わせることが現実的です。また焼き付け処理ではフォントや文字エンコード、字幕の長さ調整・改行制御、重複タイムスタンプの解消といった細かな整形ルールが UX に大きく影響します。SKILL.md によるスキル定義を活かして、外部サービスの API キー管理やローカル実行フローの切替（ローカル STT vs クラウド STT）をオプション化すると実用性が高まります。さらに CI/自動評価パイプライン（evals）で字幕の同期精度や翻訳品質を定量評価する設計も見受けられ、運用と改善サイクルが想定された構成です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • README.md: file
  • SKILL.md: file
  • docs: dir
  • evals: dir
  • package.json: file

…他 2 ファイル

上記構成から、スキル仕様（SKILL.md）と利用方法・インストール手順（README）、動作検証用の評価資産（evals）、補助ドキュメント（docs）が整備されていることが分かります。package.json はツールの配布やスキルインストールのメタ情報を含む想定です。

まとめ

AI ツールと連携して動画の二言語字幕生成と焼き付けを自動化する、実用的なスキル群を提供するツールキットです。（50字程度）

リポジトリ情報：

  • 名前: video-subtitle-toolkit
  • 説明: 유튜브·X(트위터) 영상을 다운로드해 한·영 이중자막을 자동 생성·합성하는 워크플로우로, Claude, Codex, VS Code 등에서 호출해 사용할 수 있는 스킬입니다。A workflow skill for Claude, Codex, and VS Code that downloads YouTube/X videos, auto-generates Korean–English subtitles, and burns them into the video.
  • スター数: 7
  • 言語: Python
  • URL: https://github.com/binnu-dev/video-subtitle-toolkit
  • オーナー: binnu-dev
  • アバター: https://avatars.githubusercontent.com/u/67778157?v=4