yt-retention について
YouTube の視聴者維持率 CSV を分析するコマンドラインスキルで、SRT 字幕も併せて確認できます。冒頭の離脱、急落箇所、ペースの低下を特定し、優先する変更案を一つ提示しますが、動画は公開しません。
主な機能
- 01視聴者維持率 CSV の分析
- 02急落箇所の字幕内容を確認
- 03冒頭離脱、急落、低下の分類
- 04最大の離脱箇所に対する変更案を一つ提示
- 05公開せずコピー用の出力を作成
活用シーン
- 01冒頭数秒の視聴者離脱の特定
- 02維持率の急落と字幕内容の照合
- 03動画中盤で視聴者が継続的に減るかの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jakeschincariol/ youtube-agent-skill --skill yt-retentionインストール後、Claude Code で/yt-retentionを入力して読み込まれたか確認します。
同梱ファイルretention.py
詳細
yt-retention
視聴者維持率グラフは、YouTube が示してくれる唯一の正直なフィードバックです。エクスポートしている人はほとんどいません。
python3 retention.py retention.csv --duration 600
python3 retention.py retention.csv --transcript transcript.srt
ファイルの取得方法:Studio -> 動画 -> Analytics -> Engagement -> 視聴者維持率グラフ -> ダウンロードアイコン -> "Audience retention"。
3つの異なる問題
- HOOK LEAK - 最初の30秒で失われる視聴者です。25%未満なら健全です。これは常に最初に直すべきことで、編集ではなく、必ず台本の最初の15秒です。
- CLIFFS - 急激な落ち込みです。崖は特定の瞬間に起こります。前触れのない話題の切り替え、スポンサー紹介、長い前置きなどです。
--transcriptを指定すると、その時点で何を話していたかが出力されるため、レポートが興味深いだけでなく、実際の改善に役立ちます。 - SLIDE - 中盤にかけての緩やかな減少です。平坦なスライドはペース配分の問題です。対処法は書き直しではなく、カットです。
何を伝えるか
最も大きな離脱要因を1つ挙げ、その改善策を1つ伝えてください。5つ並べるのではありません。そのうえで、求められた場合に限り、残りも伝えます。フックの離脱が健全で、スライドも平坦なら、動画に問題はなく、パッケージングが問題だと伝え、/yt-package を案内してください。
ゲート
ここでは何も公開しません。このスキルが作成し、公開するのはあなたです。すべての出力の末尾にはユーザーがコピーするブロックが入り、実行の最後の行は必ずこの質問になります:公開しますか、それとも変更しますか?
コメント
Markdown 対応