YouTubeクリッパー・スキル (Youtube-clipper-skill)

Tool

概要

YouTube Clipper Skillは、AI(Claude Code を想定)を活用してYouTube動画をダウンロード、意味的チャプター(semantic chapters)を生成し、指定した区間を切り出してクリップを作成するためのPythonベースのツールです。字幕(キャプション)の翻訳を二言語併記の形式に出力する機能や、字幕を動画に焼き込む(ハードサブ)機能も備え、教育・コンテンツ編集・要約生成などに適しています。MITライセンスで配布され、Python 3.8+ を想定した実装です。

GitHub

リポジトリの統計情報

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

主な特徴

  • YouTube動画のダウンロードと指定区間の自動クリップ作成(ffmpeg等を利用)
  • LLMを用いた意味的チャプター生成(Claude Code 想定)で章立てとタイムスタンプを抽出
  • 字幕の翻訳を二言語(バイリンガル)フォーマットで出力、字幕を動画に焼き込む機能
  • CLIと環境変数(.env)による設定管理、MITライセンスで商用利用も可能

技術的なポイント

本プロジェクトは「既存の動画処理ツール」と「大規模言語モデル(LLM)」を組み合わせる設計思想が特徴です。動画取得は yt-dlp や同等のダウンロードツールを想定し、切り出し・エンコード・字幕焼き込みは ffmpeg を用いるのが一般的なワークフローになっています。チャプター生成は生字幕や音声のテキスト化を入力として、Claude Code 等のLLMにプロンプトを投げて意味的な区切り(トピック変化点)とタイムスタンプを抽出する手法を採用します。字幕翻訳は外部翻訳APIやローカル翻訳モデルに依存し、翻訳結果をオリジナルと合わせてバイリンガルSRTなどで出力することで視聴・編集がしやすくなります。実装面では、設定を .env にまとめることでAPIキーや出力設定を分離し、スクリプト単位での処理(ダウンロード→文字起こし→チャプター生成→切り出し→字幕焼き込み)をパイプライン化できる点が魅力です。また、LLM呼び出し時のトークン制限やタイムスタンプ精度、字幕の同期(音声認識の誤差)といった実運用でのトレードオフに配慮した設計が求められます。ライセンスはMITで、拡張や組み込みがしやすい点も利点です。

プロジェクトの構成

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

  • .env.example: file — 環境変数(APIキー、出力ディレクトリなど)設定のサンプル
  • .github: dir — ワークフローやIssueテンプレートなどのCI/運用設定が入る可能性あり
  • .gitignore: file — ビルド成果物や秘密情報の除外設定
  • FIXES_AND_IMPROVEMENTS.md: file — 既知の修正点や改善案の一覧
  • LICENSE: file — MITライセンス文書

その他の主要ファイル(要旨):

  • README.md: プロジェクトの使い方、依存関係(Python 3.8+)や機能一覧
  • スクリプト群(例: ダウンロード、チャプター生成、切り出しを行うPythonファイル): 各処理を分担する小さなモジュール設計が想定される
  • サンプルまたはテンプレート(.env.example や設定ファイル): 実行前の設定を容易にする

…他 8 ファイル

(上記の構成はリポジトリのファイル名と目的を要約したものです。実際のスクリプト名や詳細はリポジトリ内ファイルを参照してください。)

まとめ

動画編集とLLMを組み合わせた実用的なクリッピングツールで拡張性が高いです。

リポジトリ情報:

READMEの抜粋:

YouTube Clipper Skill

AI-powered YouTube video clipper for Claude Code. Download videos, generate semantic chapters, clip segments, translate subtitles to bilingual format, and burn subtitles into videos.

License Python

English | 简体中文

FeaturesInstallationUsage • [Require…