yt-chapters
python3 ${CLAUDE_SKILL_DIR}/chapters.py transcript.srt --target 8
ツールはこのスキルのフォルダ内にあります。${CLAUDE_SKILL_DIR} はClaude Codeでのそのフォルダを指します。展開されない環境（claude.ai、Codex）では、このSKILL.mdが読み込まれたフォルダを使用してください。
文字起こしは ../yt-edit/deadair.py で読み込むため、両方を一緒にインストールしてください。
リンクはあるが文字起こしがない場合？ YouTubeのキャプションを一行で取得できます：
yt-dlp --skip-download --write-auto-subs --sub-langs en --sub-format vtt -o transcript "<video url>"
これで transcript.en.vtt が書き出されます。en を動画の言語に置き換えてください。自動キャプションには句読点がありませんが、whisper の文字起こしには句読点があり、よりきれいな文の区切りが得られます。
書き始める前に
~/.claude/youtube/voice.md が存在する場合はそれを読んでください。書き出すタイトルは、あなたの言葉ではなく、ユーザーの言葉で記述します。このファイルが存在しない場合は、わかりやすいタイトルをつけ、ボイスファイルがあればさらに洗練できると伝えてください。
絶対に守るべきルール
以下のいずれかに違反するチャプターリストは、自動的にチャプターとして認識されません。ブロックは説明欄にそのまま表示されるだけで機能しません。
- 最初のエントリは 00:00 でなければなりません。
- 最低3つ のチャプターが必要です。
- 各チャプターは 少なくとも10秒 の長さが必要です。
- 昇順 でなければなりません。
一部のチャンネルでは、スタジオで詳細設定を有効にしないとチャプターが表示されません。有効なリストが表示されない場合は、最初にこれを確認してください。
このツールは3つの条件すべてをチェックし、リストが無効な場合に警告を表示するため、貼り付け前に問題を把握できます。
各行をリタイトルする
chapters.py は境界をうまく見つけます。実際に取ったポーズを、その前後での語彙の変化の大きさでスコアリングします。出力されるタイトルはトピックに関する単語であり、ドラフトです。「サムネイルタイトルパッケージング」のようなチャプター名は仮のものです。各セクションの約束となるタイトルを、ユーザーの声で、3〜5語で書き直してください。
チャプターは保持率の診断ツールでもあります。あるセクションを5語で説明できない場合、それは2つのセクションに分けるか、不要な部分です。
ゲート
ここで公開されるものはありません。このスキルは書き出しを行い、公開はユーザーが行います。すべての出力はユーザーがコピーするブロックで終わり、実行の最後の行には常に質問が表示されます：送信しますか、それとも変更しますか？