channel-import - SKILL.md Agent Skill

name: channel-import description: "Use when 既存の YouTube チャンネルを自動化システムに取り込みたいとき。「既存チャンネル」「チャンネル取り込み」「config 生成」「channel-import」など、既に YouTube で運営中のチャンネルの設定ファイル生成に関わる場面で使用すること。新規チャンネル開設は /channel-new を使うこと"

既に YouTube で運営中のチャンネルの情報をヒアリングし、config/channel/*.json（責務別分割、v2.0.0 以降）を生成してこの自動化システムに取り込む。

実行場所: チャンネルリポジトリのルート

チャンネルリポジトリが存在しない場合は、以下の手順で準備:

テンプレートからリポジトリ作成:

cd ~/02-yt
gh repo create <short> --template daiki-beppu/youtube-channel-template --private --clone
cd <short>

automation パッケージのインストール:

uv add git+https://github.com/daiki-beppu/youtube-automation.git

既にリポジトリがある場合はこのステップをスキップ。

AskUserQuestion でユーザーに以下を質問:

AskUserQuestion で以下を対話的に確認:

ジャンル (genre.primary): 「どんなジャンルのチャンネルですか？」（例: Celtic, Lo-Fi, Jazz, Ambient）
スタイル (genre.style): 「スタイルをもう少し具体的に」（例: Fantasy, Smooth, Chill）
コンテキスト (genre.context): 「どんな世界観・文脈ですか？」（例: RPG Adventure, Rainy Night Cafe）
コアメッセージ (channel.core_message): 「チャンネルが届けたい価値は？」

AskUserQuestion で以下を確認:

音楽エンジン: Suno / Lyria / both
タイトルテンプレート: 既存動画のタイトルパターンを確認し、{style} {theme} Music - {activity} BGM [{duration_display}] 形式で提案
タグ (tags.base): ジャンルに適した YouTube 検索タグを 10 個程度提案
テーマ別タグ (tags.themes): 6-10 テーマのタグ群を提案
説明文設定:
- descriptions.opening: {style} {primary} music inspired by ... 形式
- descriptions.perfect_for: 4 項目（例: Study & Focus, Relaxation, Creative Work, Sleep）
- descriptions.hashtags: 5 個程度
Suno 設定（音楽エンジンが Suno/both の場合）: config/skills/suno.yaml で workspace_name / genre_line / exclude_styles を上書き（ない場合は skill default を使用）

channel-setup/references/config-template/*.json をベースに、ヒアリング結果で各ファイルの全フィールドを埋めて config/channel/*.json を生成（meta / content / youtube / analytics）。

含めるべきセクション（必須・skill-config 管理・オプション）は channel-setup/references/config-generation-rules.md を参照。

正準ディレクトリ構造は channel-setup/references/directory-structure.md を参照。既存リポジトリに不足しているディレクトリがあれば作成する。

JSON 構文検証・config ロードテスト（uv run yt-config-migrate verify）は channel-setup/references/verification.md を参照。

auth/token.json がない場合、OAuth 認証と channel_id 自動取得を実行。手順は channel-setup/references/verification.md（「OAuth 認証」「channel_id の自動取得」）を参照。

config 生成・認証完了後、以下を案内:

ブランディング素材: 未作成の場合は channel-setup/references/verification.md（「ブランディング素材生成」）を参照
ベンチマーク設定: 競合チャンネルを追加したい場合は config/channel/analytics.json の benchmark.channels を追加し /benchmark で収集
ペルソナ定義: /viewer-voice → /audience-persona → /viewing-scene の順で実行
データ収集・分析: /analytics-collect → /analytics-analyze で現状のパフォーマンスを把握
コレクション制作: /wf-new で最初のコレクション制作を開始

状況	兆候	対処
OAuth 未認証/失効	`auth.oauth_handler` の `FileNotFoundError`（`client_secrets.json` 不在）/ `AuthError` / HTTP 403	初回認証フローを再実行。403 が続く場合は `auth/token.json` を削除しスコープを確認のうえ再認証
YouTube quota / rate	HTTP 429 / 403 `quotaExceeded`	日次 quota（既定 10,000 units・太平洋時間 0 時リセット）を待つか呼び出しを抑える
API 障害 / サービス停止	HTTP 503 / タイムアウト	Google Cloud / YouTube のステータスを確認し、時間を置いて再実行
`gh` CLI 不在/未認証	`command not found: gh` / `gh auth` エラー	`gh` を install し `gh auth login` を実行