Communitygithub.com

paxon-yang/talking-video-skills

一句话需求から口播・動画解説の完成品を自動生成します(ナレーション・字幕・デジタルヒューマン・アニメーション・音効・サムネイル・コピー)。ユーザーが「Xについての動画を作って」「口播動画を作って」などと言うだけで、全工程を自動推進します。

talking-video-skills とは?

このスキルは、ユーザーが「〇〇についての動画を作って」と一言言うだけで、ナレーション・字幕・動画アニメーション・音効・レンダリング・自己チェック・サムネイル・コピーまでを全て自動で行い、完成品を納品するためのエントリーポイントです。Claude(または対応するAIエージェント)がワークフロー全体を指揮し、デフォルト値で自動的に工程を進めます。ユーザーに確認が必要なのは「デジタルヒューマンの有無」「音声の取得方法」など、動画構造に影響するごく一部の質問だけです。対応プラットフォームは主にClaude Codeを想定しており、動画編集の専門知識がなくてもプロ級の口播動画・動画解説動画が作成可能です。ワークフローは原稿作成(S1)→ナレーション録音(S2)→字幕アライメント(S3)→デジタルヒューマン合成(S4)→クロマキー(S5)→タイムラインデータ生成(S6)→アニメーション(S7)→レンダリング(S8)→自己チェック(S9)→サムネイル・コピー作成(S10)の10工程で構成され、各工程は自動またはユーザーの最小限の操作で完了します。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/paxon-yang/talking-video-skills/tree/HEAD/skills/talking-video-oneshot

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

一言から完成品へ:エントリーポイント

目標:ユーザーが要件を一言だけ伝えれば、Claude が原稿・字幕・アニメーション・音効・レンダリング・自己チェック・サムネイル・コピーを全て実行し、完成品を納品する。毎ステップ確認を取らない、ユーザー自身で決定できることは確認を求めない。

事前準備チェック(作業開始前30秒)

../video-asset-prep/SKILL.md の準備リストを確認:デジタルヒューマン(出演版のみ必要)、音声、アセットライブラリ、固定テンプレート。不足があればそちらに移って準備してから作業を進める。不足したまま無理に進めない;純アニメーション版はデジタルヒューマン不要。準備が整ったら、以降は全て自動で進める。

0. 要件収集(最大1回、3つの質問をまとめて)

動画の構造を変える、かつデフォルト化できないことだけ質問する。ユーザーが答えなかったものは全てデフォルト値で進める:

質問デフォルト
テーマと主張(一言、またはラフ原稿)必須
デジタルヒューマンの出演有無?なし(純アニメーション)。ありの場合はユーザーのデジタルヒューマン映像とナレーションが必要
ナレーションの出典は?ユーザー自身のクローン音声で生成したオーディオを送ってもらう;なければシステムTTSで仮配置して全フローを通し、本番ナレーションが届いたらアライメントのみ再実行

固定デフォルト:1920×1080、30fps、60–80秒、BGMなし(音声+音効のみ、音楽はユーザーが後付け)、字幕キャプションスタイル、テーマに応じてライトまたはダーク、ラウドネス −16 LUFS、サムネイルは横・縦各2枚、コピー1行。

1. パイプライン(自動推進)

ステップ処理内容担当成果物 / チェックポイント
S1 原稿8–12文のナレーションに圧縮:各文 ≤20字、一文一義、数字は独立文に;AI臭を排除(短文・口語・対比少なめ);事実確認;文字数 ≈ 尺×4.8Claudescript_lines.json;事実に疑問があればユーザーに確認
S2 ナレーション原稿を読み上げツール向けに書き換え(略語は A I のように一字ずつ)→ ユーザーが音声生成 → ローカルでポーズは最大0.4秒ユーザーが音声提供voice.mp3;これだけは必ずユーザーを待つ工程(なければ仮配置)
S3 アライメントwhisper でワード単位に強制アライメント → 字幕を単語で区切る → 波形と独立に先頭タイミングを確認Claudewords.json subs.json;字幕の先頭は3フレーム以内
S4 デジタルヒューマン(任意)ブラウザ駆動でデジタルヒューマンツール:音声アップロード→生成→ダウンロード。認証・決済・削除はユーザーのみClaude + ユーザーグリーンバックmp4
S5 クロマキー(任意)色差キー+エッジ拡張 → VP9 alpha WebM;デコードカーブ補正;口パク先行3フレームClaudekey_host.py
S6 タイムラインデータ全カット時間を単語アライメントから算出(文頭 −6フレームをカットポイント)、フレーム番号を手打ちしないClaudetimeline.ts 唯一の情報源
S7 アニメーション一文一カット、一台のカメラ、一つのフォーカス;タイプライター効果は全て typing.ts に登録;音効はイベントベースで生成Claudeae-motion-craft 参照
S8 レンダリング分割+ウォッチドッグ:5分間新しいフレームが生成されなければプロセス強制終了、最大3回リトライ;各セグメントの開始・終了時刻をログ出力Claude分割mp4 → 結合 → ミキシング
S9 セルフチェック第3節のリストに従い、実際のファイルタイムスタンプとログを照合、感覚で「もうすぐできそう」と言わないClaudeチェックリスト
S10 パッケージ横+縦サムネイル(メイン+代替)、サムネイルサイズチェック、SNS向け一行コピーClaudeサムネイル4枚+コピー

2. 人間だけが行うこと(それ以外は全て自分でやる)

ナレーション音声の生成、デジタルヒューマンの認証・決済確認・アカウント/イメージ削除、最終的な美的チェック。これらに遭遇したら一度に必要なものを全て伝える、複数回に分けて質問しない。

3. セルフチェックリスト(納品前に1行ずつ ✓/✗/数値を記入)

  • 尺:動画と音声の差 ≤0.05 s;ffprobe 1920×1080 / 30fps / BT.709
  • ラウドネス −16 LUFS(音声+音効)、ピーク < −1 dBFS;音効は音声より ≥10 dB 低い
  • 字幕:各行の先頭と波形の誤差 ≤3フレーム、時刻の重複なし、スタイル統一
  • 紫色ピクセルの割合(紫ラインが不要な場合)<0.2%;カットポイントは2フレームステップでハードジャンプなし
  • 各タイプライターブロック:文字数 = キー音数
  • 画面にサードパーティブランド・実在人物・内部ファイル名なし;中国語動画の画面上文字は汎用的な用語
  • レンダリング成果物のタイムスタンプが最終変更より後;ログに失敗セグメントなし

4. 鉄則(踏んだこと)

  1. 原因を推測しない:レンダリングが止まったら、まずファイルの更新日時 vs 現在時刻、ログ全体を読んでから結論を出す。
  2. ユーザーに監視させない:長時間タスクは各セグメントにタイムスタンプを付け、止まったら自分で検出してリトライする。
  3. まず静止画 / 低解像度プレビューで自己チェックしてから1080pでレンダリング。
  4. 字幕は必ず単語単位でアライメント、文字数で推定しない。
  5. BGMなし;説明用の小文字テキストを入れない;明るい背景に大きめの暗色ブロックを配置しない;紫色は使わない。
  6. ユーザーが具体的なフィードバックをくれた場合、影響のあるカットだけ再加工、全体をやり直さない。
  7. 納品後、プロセスを繰り返し報告しない。以下のみ伝える:配置場所、変更内容、既知の不具合、サムネイル、一行コピー。

5. 関連

  • 事前準備(デジタルヒューマン / 音声 / アセット / 固定テンプレート):../video-asset-prep/SKILL.md
  • 本スキルの詳細は references/ ディレクトリ:原稿とフック(hooks-and-copy、thinking、templates)、絵コンテと画面設計(visual-mapping、motion-and-camera、packaging)、字幕アライメント(subtitle-sync)、快適性ルール(comfort-rules)、全フローマニュアル(production-playbook)、ナレーション動画融合(hosted-video-fusion)、レンダリングとパイプライン(remotion-pipeline、promo-and-hosted-pipeline)、音効(motion-polish-and-sfx)、コラボレーション(collaboration)、中・英語版(english)、サムネイル素材(gemini-asset-prompts)。
  • references/legacy-combo-style-SKILL.md は分割前の旧概要。参照用のみ。ファイルパスは現在のディレクトリを基準とすること。
  • スクリプト:scripts/、../../pipeline-scripts/;完全な方法論:../../方法論-制作篇.md

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

paxon-yang/talking-video-skills

用户提供自己的数字人视频(或先拿 Claude 写的口播稿去数字人工具生成),和 Claude 多轮沟通、逐轮打磨,按 combo 风格(博主A × 博主B 合并后的"暗底固定框架 + 数字人口播 + 少而准的动效")做出 1–3 分钟横屏精品讲解视频,目标是成片和原片一样精美。用户说"按 combo 风格/博主A风格/博主B 风格做视频""我有数字人视频,帮我包装/加动效""帮我写数字人口播稿/脚本""出分镜表""给剪映剪辑说明""做 Remotion 动效视频/写 timeline.json/出样张/预览/渲染""这条视频不够精致,再改改"时使用。流程是协作轮次:素材接收 → 稿子 → 分镜 → 关键帧样张(与原片并排) → 低清预览 → 精修终版;每轮交给用户看、请用户确认、按反馈修改,可随时回到前面任一轮。

paxon-yang/talking-video-skills

做口播 / 动效视频之前的备料:数字人(形象、绿幕生成、抠像、清晰度、口型校准)、克隆声音(读音规则、停顿处理)、沉淀动效积木(拆解参考视频→提取带数值的规律→做成带参数的组件→逐镜头复刻验证)、固定框架(字幕胶囊、背景、封面)。用户说「准备数字人」「学这个动效」「拆一下这个视频的动效」「沉淀成积木」「做我自己的动效库」「备料」「我还缺什么才能开始做视频」时使用。备齐后用 talking-video-oneshot 做片。

関連スキル