Communitygithub.com

ll-video-progress

SRT字幕から剪映(Jianying)にインポート可能な透明チャプタープログレスバーを作成します。チャプターと原文範囲を確認後、Playgroundでユーザーがスタイル名を選択し、配色やキャラクターの置き換えに対応、細長い透明MOVファイルを納品します。短い動きのあるテキストアニメーションや完全な動画編集には使用しません。

ll-video-progress とは?

このスキルは、SRT字幕ファイルから動画のチャプター区切りを示す透明なプログレスバーを生成し、剪映(Jianying)などの動画編集ソフトでオーバーレイとして使用できるようにします。まず、ユーザーがアップロードしたSRTファイルをもとに、字幕の内容や話題の転換点に基づいて適切なチャプター分割を提案し、ユーザーの確認を経てから、動画のアスペクト比(4:3、16:9、3:4など)を尋ねます。その後、Playgroundサーバーを起動して実際の動くサンプルを表示し、ユーザーが「ソフトホワイトグリーン」「人物先導」「ドットライン」など5種類の検証済みスタイルから選択できるようにします。選択されたスタイルに合わせて色やキャラクターをカスタマイズでき、最終的に細長いProRes 4444形式の透明MOVファイルを出力します。このスキルは、チャプター進捗バーの作成に特化しており、短いテキストアニメーション(ll-video-motion)や完全な動画編集(ll-video-edit)とは異なるワークフローを提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/liuliu-66-create/ll-video-progress/tree/main

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

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

ドキュメント

ビデオチャプタープログレスバー

ユーザーフロー

  1. まず、ユーザーが現在の会話でSRTファイルをアップロードしているか、今回使用するSRTファイルのパスを明確に指定しているかを確認します。このソースからの字幕のみを直接読み取ることができます。現在の会話にユーザーから提供されたSRTがない場合は、まず「このビデオのSRT字幕ファイルをアップロードしてください。字幕をもとにテーブルでセグメント案を提案しますので、確認が取れ次第プログレスバーを作成します。」と返信し、ユーザーが提供するのを待ちます。この時点では、ファイル検索、字幕読み取り、内容分析、プログレスバー生成は実行しません。ローカル、現在のワークスペース、過去のプロジェクト、ダウンロードディレクトリ、他の会話、または記憶にあるSRTを検索してはいけません。また、適切に見えるSRTを選び出すこともしてはいけません。現在の会話でユーザーが既に提供したファイルは再利用可能で、再度要求する必要はありません。複数のファイルが提供され、どれを使うか指定がない場合は、まず質問します。指定されたファイルが読み取れない場合は、ユーザーに再アップロードまたはパスの確認を依頼し、代替ファイルを検索しません。ユーザーがスタイルの表示や固定長サンプルの作成を明確に要求した場合のみ、内蔵サンプルコンテンツを使用できます。「プログレスバーを作成して」という一言はこの例外に該当しません。
  2. 完全なSRTを読み取り、内容の意味、話題の転換点、ビデオの長さ、ユーザーの要件に基づいてチャプター数を提案します。固定のセグメント数上限は設けません。ユーザーが指定した分割方法を優先します。最初に「Xセグメントに分割することを提案します」と説明し、その後、以下のテーブルでセグメント案をリストアップする必要があります。ユーザーの確認を待ってから続行します。ユーザーが結合や分割を要求した場合は、テーブル全体を更新し、再度確認を取ります。テーブルの代わりにプレーンテキストリストを使用せず、ユーザーにタイムコードを確認するよう要求もしません。
  3. セグメントが確定した後、現在のセッションでビデオのアスペクト比がまだ明確でない場合は、必ず「動画の画面アスペクト比は 4:3、16:9、それとも 3:4 ですか?他の比率でも構いません。」と質問する必要があります。回答を受けてから続行します。字幕、古いサンプル、またはPlaygroundのプレビューサイズからアスペクト比をデフォルトで推測してはいけません。アスペクト比が既に明確であるか、元のビデオからサイズを確認できる場合は、そのまま使用し、再度質問しません。
  4. このスキルのscripts/playground_server.mjsを実行し、今回の起動で返されたprogressUrlを開いて、実際の動くサンプルを表示します。起動スクリプトは同じバージョンのサービスを自動的に再利用し、ポートが他のプログラムや旧バージョンによって占有されている場合は自動的にポートを変更します。デフォルトポートの占有をインストール失敗と見なさず、未確認バージョンの古いページを直接再利用したり、不明なプロセスを終了したりしないでください。ユーザーにスタイル名を返信してもらい、アニメーションの実装やエンコードを判断するよう要求しません。選択済みのスタイルを再度選択することはありません。
  5. ユーザーが「人物先導」または「テキスト先導」を選択した場合のみ、人物を処理します。references/characters.md に従い、ローカルに保存されている個人のデフォルト人物を読み取ります。ユーザーが今回の使用のために既に人物を指定している場合は、今回の選択を優先します。そうでない場合、個人のデフォルト人物が存在すればそのまま使用し、簡単にその旨を伝え、再度要求したり生成したりしません。記録がない場合のみ、カスタム画像を提供するかどうかを尋ね、提供がなければ内蔵人物を使用します。返信がないことは「提供しない」と同義ではありません。新しいカスタム人物の歩行エフェクトはユーザーの確認後、ローカルにインストールされたスキル内の user-data/characters/ に保存され、次回のデフォルトとして使用されます。ユーザーが今回のみの使用を明示した場合は、デフォルトを変更しません。人物なしのスタイルを選択した場合は、人物に関する質問、読み取り、保存は行いません。個人の原画像、アニメーションフレーム、設定は、公開アセット、SKILL.md、Gitコミット、またはGitHubに書き込んではいけません。インストールを更新する際は、ローカルの user-data を保持します。
  6. 確定したビデオアスペクト比、チャプター、スタイルに基づき、references/rendering.md に従って設定を保存し、dry-run、生成、チェックを行い、細長いProRes 4444 MOVを納品します。字幕が作成後に追加、削除、または速度変更された場合は、再同期が必要です。

セグメント案の固定出力フォーマット

段落プログレスバー短タイトル内容概要開始原文終了原文
1短いチャプター名この段落の内容SRTから一字一句引用した最初の文SRTから一字一句引用した最後の文

各段落は1行で、タイトルはプログレスバーに使用され、概要はユーザーがセグメントを判断するのに役立ち、原文範囲はユーザーが位置を特定するのに役立ちます。テーブルの後、ユーザーに採用するかどうか、または結合、分割、タイトル変更が必要な箇所を指定するよう確認を取ります。原文を要約に書き換えてはいけません。チャプターが多すぎてテキストが収まらない場合は、実際のレイアウト上の問題を説明し、タイトルの短縮、フォントサイズの調整、または他のレイアウト案を提案し、ユーザーが決定します。スタイルに適合させるために強制的に5セグメントに圧縮したり、確認済みのチャプターを勝手に結合したりしてはいけません。

確認情報は現在のセッション内で有効であり、再度要求することはありません。明確な許可なしに、原稿、字幕、または元のビデオを変更してはいけません。

検証済みスタイル

  • ソフトホワイトベース(soft-white-green):直角の横棒、半透明の白い背景、白いチャプターテキストと縦線の区切り、塗りつぶしはそのセグメントの時間の経過とともに進行します。

  • 人物先導(walking-leading):上記の横棒をベースに、塗りつぶしの最前線を先導する人物を追加します。人物は棒と同じ高さで、体は下に移動し、棒の外側には最大で棒の半分の高さまでしか出ません。棒の上を歩くことはありません。

  • ドットライン(dot-line):細い線とドットがチャプターの進行とともに色が変わり、テキストとドットの間隔は6pxです。

  • ショートセグメント(short-segments):各チャプターに1本の短い線があり、そのチャプターの時間に応じて色が塗られます。テキストと短い線の間隔は6pxです。

  • テキスト先導(text-leading):テキストがチャプターの進行とともに色が変わり、人物が最前線を先導します。長い棒の背景色はありません。小さなフォントサイズで輪郭はなく、4倍精度で描画され、単一の透明度で合成されます。

5つのスタイルすべてでRGB塗りつぶし色を自由に変更できます。新しく追加された3つのスタイルは18~72pxのフォントサイズ(エクスポートピクセル基準)をサポートし、デフォルトはそれぞれ24、26、25pxで、出力高さはテキストに自動的に適合します。緑色は単なるデフォルト色であり、ユーザーがPlaygroundで選択した色番号を正式な設定に書き込む必要があります。プレビューで色を変更しても、エクスポート時に緑色のままにしないでください。

ルールの真正なソースは references/confirmed-rules.md であり、登録テーブルは assets/progress/styles.json です。検証済みスタイルのみを表示および生成します。新しいスタイルは、ユーザーが実際のサンプルを見て承認した後に登録されます。

検収と納品

  • スクリプトは、字幕範囲、タイトルレイアウト、サイズ、完全なデコード、フレーム数、長さ、透明ピクセルをチェックします。エージェントはまた、コンタクトシート、実際のエクスポートフレーム、動的プレビューを開き、キャラクターのループ、クリッピング、チャプター切り替え、色を確認する必要があります。
  • ソフトホワイトベース 1440×64;人物先導 1440×96、棒の高さ64、人物最大64、下部露出最大32。新しく追加された3つのスタイルのデフォルトサイズはそれぞれ、1440×78、1440×70、1440×96。テキスト先導の人物最大64、下部露出最大32。棒の高さを変更する場合は同じ比率で計算し、デフォルトではキャンバス全体をエクスポートしません。
  • ダウンロードされるのは細長いProRes 4444 MOVです。透明WebMはブラウザプレビュー用です。reference-qtrle.mov は内部検証専用であり、納品しません。透明動画の代わりに通常のMP4を使用しないでください。
  • バーと人物以外は透明でなければなりません。プレビューの背景色、斜線、チェッカーパターンはファイルに焼き付けてはいけません。
  • ユーザーが今回の細長いProRes 4444が剪映で使用可能であることを確認済みです。新しいファイルもチェックが必要であり、ブラウザで正常に表示されることやアルファチャンネルがあることを、あらゆるバージョンの剪映でサポートされることと同一視してはいけません。
  • 絶対パスの完成品リンクを返し、元のビデオの上のトラック、先頭に合わせ、元の速度を維持し、幅全体に広げて上部に移動するように説明します。サンプルには明示的に長さを記載し、ユーザーのビデオ全体の長さのプログレスバーとして偽装してはいけません。

テキストから数秒の独立した短い動きのあるアニメーションを生成するには ll-video-motion を、ナレーション、全編字幕、連続素材の編集には ll-video-edit を使用します。

関連スキル