القائمة
Use when 各コレクションの音楽ムード × サムネイル雰囲気 × タイトル訴求の整合性を監査したいとき。「整合性チェック」「一致してるか確認」「タイトル見直し」「サムネと音楽の一致」「タイトル改善」「CTR改善」など。CTR に最も影響するチェックポイント。方向性見直し時に必ず使用すること
Use when Suno UI に投入する音楽プロンプト (Style + Lyrics) を生成したいとき。SunoAI V5 向けの YAML 定義（インストは `tracks_per_collection` で曲数指定の独立 entry 並列、ボーカルは pattern × tracks_per_pattern 設計）から suno-prompts.md / suno-prompts.json を作成する（次工程 `/suno-helper` でブラウザ自動生成 + playlist 一括追加、その後 `/masterup` で DL + マスター化）。プロンプト作成・Style 文・Lyrics テンプレートなど Suno 連続生成の前段で使用すること。Lyria チャンネルでは /lyria を使う
Use when Suno UI に投入する曲をブラウザで連続生成 + playlist 追加したいとき。yt-collection-serve で suno-prompts.json を配信し、suno-helper Chrome 拡張で 1 タブ完結の自動実行（pattern 注入 → Generate → 完了待機 → 次へ → 全件完了で playlist 一括追加）を回す operator 手順。`/suno` でプロンプトが揃った後、または既存 collection の途中再開で使用する
Use when まだコレクションディレクトリが存在せず、新規コレクション制作を立ち上げたいとき。「新しいコレクション始めたい」「制作開始」「新規ワークフロー」など、企画選択からディレクトリ作成・素材準備までを行う初期化フェーズで使用する。既存コレクションの進行は /wf-next
Use when 収集済みのAnalyticsデータを詳細分析し、戦略的改善提案が必要なとき。/analytics-collect でデータ収集後に実行。CTR改善、パフォーマンス分析、戦略検討、データ分析、コレクション比較、投稿の振り返りなど、データに基づく判断が求められる場面で必ず使用すること
Use when YouTube Analyticsデータの収集・最新化が必要なとき。/analytics-analyze 実行前のデータ準備ステップとして使用。ユーザーが「データ更新」「最新の数字」「統計を取得」「分析の準備」と言及したとき、または analytics_system.py の実行が必要な場面で必ず使用すること
Use when Analytics分析レポートの表示・閲覧が必要なとき。過去レポートの比較やパフォーマンスレビュー時に使用。「レポート見せて」「過去データ確認」「パフォーマンスレビュー」「前回の分析結果」など、既存レポートの参照・比較が必要な場面で必ず使用すること
| name | alignment-check |
| description | Use when 各コレクションの音楽ムード × サムネイル雰囲気 × タイトル訴求の整合性を監査したいとき。「整合性チェック」「一致してるか確認」「タイトル見直し」「サムネと音楽の一致」「タイトル改善」「CTR改善」など。CTR に最も影響するチェックポイント。方向性見直し時に必ず使用すること |
公開済み全コレクションの音楽プロンプト・サムネイル・タイトルを横断的に監査し、 不一致箇所を特定。タイトルフォーマットの改定案も提示する。
config/channel/ が存在すること（load_config() でロード可能）。
存在しない場合、ユーザーに確認:
/channel-new を案内/channel-import を案内2つのサブエージェントを並列起動（Agent ツール）:
Agent 1: コレクション × サムネ × 音楽プロンプト収集
collections/live/ の全コレクションを列挙workflow-state.json — タイトル、テーマ、活動タグ。planning.music（mood / atmosphere / tempo / instruments）があれば優先採用20-documentation/suno-prompts.md or lyria-prompt.md — 音楽ムード・楽器・テンポの補助資料Agent 2: ベンチマークタイトル構造分析
data/benchmark_YYYYMMDD.json（最新）を読み込みconfig/channel/content.json の title.template）との比較Agent 1 の結果から、全コレクションのサムネイルを Read ツールで順に表示:
collections/live/*/10-assets/thumbnail.jpgPhase 1-2 の結果を統合し、各コレクションの整合性を判定:
| 動画 | 音楽ムード | サムネ雰囲気 | タイトル訴求 | 整合性 |
不一致箇所には ⚠️ を付け、具体的な改善提案を付記。
現行 vs ベンチマーク比較に基づき、新タイトルフォーマット案を提示。 既存動画のタイトル変更候補も提案（YouTube Studio で手動変更可能）。
タイトルの語彙チェック:
AskUserQuestion で新タイトルフォーマットを確認。
docs/plans/alignment-audit.md を生成。
必要に応じて config/channel/content.json のタイトルテンプレートを更新。
整合性監査はローカルの成果物を読むだけで、外部サービスを呼ばない。
| 状況 | 兆候 | 対処 |
|---|---|---|
| 入力データ/設定の不在 | 参照先のローカルファイルが見つからない | 該当ファイルを用意するか前段スキルを先に実行（外部サービスに依存しないため API 障害・quota の影響は受けない） |
config/channel/content.json — title.template, title.theme_activitiesdocs/benchmarks/common-patterns.md — 5つの成功法則collections/live/*/10-assets/thumbnail.jpg — サムネイルcollections/live/*/20-documentation/ — 音楽プロンプトcollections/live/*/workflow-state.json — タイトル・テーマdata/video_analysis/<slug>/<video_id>.json — /video-analyze の thumbnail_alignment 出力（サムネ vs 本編の整合性監査の根拠）docs/plans/alignment-audit.md 保存後、不整合カテゴリに応じて以下のスキルを再実行する:
| 不整合カテゴリ | 症状 | 再実行スキル |
|---|---|---|
| サムネ不一致 | 音楽ムードとサムネ雰囲気がズレ（例: lofi なのに派手な色調） | /thumbnail <collection> — 対象コレクションのサムネイル再生成 |
| 音楽ミスマッチ | テーマ・タイトルと音楽プロンプトがズレ（例: 「rain」テーマなのに upbeat） | /collection-ideate で企画段階から見直し、その後 /suno または /lyria で再生成 |
| タイトル改善のみ | サムネ・音楽は OK だがタイトルの訴求/語彙が弱い | YouTube Studio で手動変更 + config/channel/content.json の title.template を更新 |
| 横断的な方向性ズレ | 複数コレクションで同じ不整合パターン | /channel-direction でチャンネル全体の方向性を再検討 |
再実行後は /alignment-check を再度走らせて解消を確認する（フィードバックループ）。