菜单
Use when release 型チャンネル（話す系・楽曲リリース）でショート動画を生成したいとき。`${motif}-{jp,en}.mp4` から JP+EN 各 1 本ずつ 9:16 縦型クリップを生成する。「リリースショート」「楽曲ショート」「JP/EN クリップショート」「サビ抽出」「short-release」など、release 型チャンネルのショート制作に関わる場面で必ず使用すること。BGM テイスター（collection 型）チャンネルは `/short` を使う
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | short-release |
| description | Use when release 型（楽曲リリース）チャンネルで JP+EN の 9:16 クリップを生成するとき。「リリースショート」「サビ抽出」で発動。collection 型は /short |
config.youtube.content_model.type == "release" のチャンネル向けに、本編リリース動画
（${motif}-{jp,en}.mp4）から JP・EN の 2 言語ぶん 9:16 縦型ショートを生成する。
楽曲のサビ部分を抜き出して縦型クロップ + スケール変換する。
現行の yt-upload-shorts は collection ディレクトリ向けの uploader であり、release ディレクトリや
言語指定つきアップロードには未対応。release 型ショートのアップロード自動化が必要な場合は、
別実装タスクとして扱う。
前提確認や Step 1 に入る前に、以下を必ず Read（Codex では同等のファイル閲覧）で開く。SKILL.md の説明や記憶から設定値を推測しない。
.claude/skills/short-release/config.default.yamlconfig/skills/short-release.yaml（存在する場合）読み込み後は youtube_automation.utils.skill_config.load_skill_config("short-release") と同じ deep-merge 前提で、チャンネル上書きを優先して扱う。存在しない override は未設定として扱い、勝手に作成しない。
config/channel/ がロード可能（load_config()）config.shorts.enabled == true（config/channel/shorts.json）config.youtube.content_model.type == "release"video/${motif}-jp.mp4 と video/${motif}-en.mp4 が存在する（motif は release ディレクトリ名から先頭の <番号>- を除去したもの）| コマンド | 説明 |
|---|---|
bash .claude/skills/short-release/references/generate-shorts.sh <release-path> | デフォルト位置で JP/EN 縦型変換 |
bash .claude/skills/short-release/references/generate-shorts.sh <release-path> -s 30 -t 40 | 開始秒・尺を指定 |
from youtube_automation.utils.config import load_config
cfg = load_config()
assert cfg.shorts.enabled, "config/channel/shorts.json で shorts.enabled=true にしてください"
assert cfg.youtube.content_model.type == "release", "collection 型は /short を使ってください"
失敗時は対応 skill を案内して終了。
ls <release-path>/video/ # ${motif}-{jp,en}.mp4 が必要
JP / EN の片方しか無い場合は cfg.shorts.release.languages で投稿対象を絞れる。両方無ければ録音・編集前提のため早期終了。
config.shorts.release.start_sec / duration_sec を初期値として提示し、AskUserQuestion でサビ位置を確認:
ffplay <release-path>/video/${motif}-jp.mp4 -ss 30 で先頭 30s から再生bash .claude/skills/short-release/references/generate-shorts.sh <release-path> -s 30 -t 40
出力: <release-path>/video/short-{jp,en}.mp4。中央クロップ（crop=ih*9/16:ih）→ 1080x1920 へスケール → fps=30。
open <release-path>/video/short-{jp,en}.mp4
この skill は生成物の確認までを扱う。release 型ショートのアップロード実行と、 workflow-state へのアップロード結果記録は未実装。
workflow-state.json::post_upload.shorts の実装済み schema は collection 型 yt-upload-shorts 向けの list 形式:
"post_upload": {
"shorts": [
{
"short_num": 1,
"video_id": "xxx",
"publish_at": "2026-03-12T08:00:00+09:00",
"uploaded_at": "2026-03-11T09:12:00+09:00"
}
]
}
上記は collection 型 yt-upload-shorts の実装済み schema。release 型の JP/EN 別 upload schema は
未実装のため、単一 object に言語別キーを持たせる形式は使わない。
| 配置 | ファイル | 責務 |
|---|---|---|
| チャンネル運用 | config/channel/shorts.json | enabled / shorts.release.languages / shorts.release.start_sec / shorts.release.duration_sec |
| skill 動作 | .claude/skills/short-release/config.default.yaml | クロップ / スケール / コーデック設定 |
| チャンネル上書き | config/skills/short-release.yaml | skill-config の差し替え |
| 項目 | 値 |
|---|---|
| アスペクト比 | 9:16（1080x1920） |
| 推奨長 | 30-45 秒（shorts.release.duration_sec） |
| 最大長 | 60 秒 |
| フレームレート | 30fps 必須 |
| 構成 | JP / EN それぞれ 1 本（shorts.release.languages で生成対象を選択可） |
motif=$(basename <release-path> | sed 's/^[0-9]*-//')。番号プレフィックスを必ず除去すること${motif}-jp.mp4 か ${motif}-en.mp4 の片方しか無い場合は skip。両方欠落で early-exitfps=30 フィルタなしで生成すると YouTube がショート認識しない（generate-shorts.sh が常時付与）open <release-path>/video/short-jp.mp4 確認前にアップロードしないこと。冒頭が無音だと最後まで再生されないgenerate-shorts.sh は JP / EN 各 1 本の縦型変換を ffmpeg で走らせるため 1〜2 分 程度かかる。必ず Bash ツールを run_in_background=true で起動する。これによりユーザーは処理中も同じセッションで質問できる（Claude Code は完了時に自動でメッセージ通知するため、sleep ループや until での自前ポーリングは禁止）。
spawn 例:
bash .claude/skills/short-release/references/generate-shorts.sh <release-path> -s 30 -t 40 \
> /tmp/short-release-$(date +%s).log 2>&1
これを Bash run_in_background=true で投げ、spawn 直後に次のメッセージを返す:
⏳ JP/EN 縦型クリップを background 生成中（推定 1〜2 分）。完了まで他の質問にもお答えできます。 ログ: /tmp/short-release-*.log
cmux 環境下（$CMUX_WORKSPACE_ID あり）であれば補助で cmux set-status "short-release" "running" --icon "hourglass" --color "#f59e0b"、完了で cmux clear-status "short-release" + cmux notify --title "short-release 完了" を呼ぶ（非 cmux 環境では skip）。
完了通知が届いたらログ末尾から結果サマリー（short-jp.mp4 / short-en.mp4 のパス）をユーザーへ返す。失敗時は ffmpeg のエラー行を抜き出して報告する。
/short を使う/wf-statusUse when YouTube Analytics データの収集・最新化が必要なとき。「データ更新」「統計を取得」「分析の準備」で発動。/analytics-analyze の前段
Use when コレクションの楽曲を DistroKid 配信用に準備し、distrokid-helper Chrome 拡張へ渡すローカルサーバーを起動したいとき（30-distrokid 生成 / disc 分割 / metadata.md / ジャケット 3000×3000 新規生成 / uv run yt-collection-serve 起動）。『DistroKid 準備』『配信準備』『アルバム化』『distrokid-helper』で発動。DistroKid Web への転記・アップロード操作そのものは Chrome 拡張側の責務
Use when Suno UI で生成した曲のプレイリストを一括 DL + マスター化するとき（前工程 /suno、次工程 /videoup）。Lyria チャンネルでは不要
Use when プレイリストの作成・割り当て・確認をするとき。「プレイリスト作って」「初投稿」「初回投稿」「初回公開前にプレイリスト初期化」「/playlist」で発動
Use when Suno UI に投入する曲をブラウザで連続生成 + playlist 追加 + 一括ダウンロードしたいとき。uv run yt-collection-serve で suno-prompts.json を配信し、suno-helper Chrome 拡張で 1 タブ完結の自動実行（pattern 注入 → Generate → 完了待機 → 次へ → 全件完了で playlist 一括追加 → ZIP 一括 DL）を回す operator 手順。`/suno` でプロンプトが揃った後、または既存 collection の途中再開で使用する
Use when Suno ボーカル曲の歌詞を生成するとき。「歌詞生成」「vocal」「rap」「suno-lyric」で発動。/suno の前工程。Style / UI 投入は /suno と /suno-helper の責務