ketchup-video について
ketchup-video は、実際のスクリーンショット、録画、差分、データを使って、最近の作業を短い無音動画にまとめるスキルです。スライドの選定と構成、動画の書き出し、各フレームの可読性確認を定めています。
主な機能
- 01作業成果物からスライドを作成
- 02連続する図で変化を表現
- 03完了・失敗・保留を明示
- 04無音の横長動画をレンダリング
- 05表示時間に応じて可読性を確認
活用シーン
- 01コード変更と前後の結果を動画で振り返る
- 02PRスタック内の各PRの状態を示す
- 03依頼事項の結果と残作業を報告
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mdsmithaustin/ pstack --skill ketchup-videoインストール後、Claude Code で/ketchup-videoを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
Ketchup動画
ketchupスキルを使用します。要約やビジュアルの代わりに、起きたことを短い無音動画で見せてください。キャッチアップの対象期間は、/ketchup-videoより前にユーザーが書いた最後のメッセージから始まり、それ以前の/ketchupより前からではありません。リポジトリ外で動画を作成してレンダリングすることは、ketchupの読み取り専用ルールの唯一の例外です。返信は、ketchupの冒頭文、埋め込み動画、自分で対応できる残作業を示す1行、そしてアクションアイテムで構成します。動画で呼び出しのオプションを示す場合は、動画内で使われている名前で各オプションを呼んでください。レンダリングに失敗した場合は、その旨を1行で伝え、呼び出しだけを提示します。
スライド
チャット内の説明文ではなく、作業で生成されたスクリーンショット、録画、差分、データを使います。描画を始める前に、ユーザーに覚えて帰ってほしい一文と、スライドごとの1行を書きます。ユーザーが知る内容に変化をもたらさないスライドは削除します。スライドは最大10枚とし、少ないほどよいです。どちらのメモも返信には含めません。
各スライドでは、1つのことだけを伝えます。1つの画像を土台にして、スライドごとにその画像を変化させます。無関係な画像へ切り替えてはいけません。色や形の意味は、すべてのスライドで統一します。システムの仕組み、各PRの状態を示したPRスタック、修正前後の比較、選択肢の並列表示など、作業内容を図で示します。矢印、ハイライト、動きで変更点を示します。スライドを箇条書き、ステータス一覧、表、つながりのない枠だけで構成してはいけません。
テキストは必要最小限にします。ラベルは、それが指す対象の上に、たとえば「テスト:合格」のようなタグではなく、人が口にする平易な言葉で配置します。画像の内容をキャプションで説明してはいけません。また、スライド間やスライド下のテキストで、同じ事実を二度伝えてはいけません。
ユーザーが求めた各項目の結果と、完了、実行中、失敗、未確認のいずれかを示します。ユーザーの対応待ちのものを、完了済みとして見せてはいけません。途中で見つけて修正したバグがあれば示します。画面上の変更を示すスクリーンショットがない場合は、そのスライドでその旨を伝え、画面上で何が変わったかを記します。確認できた事実だけを使います。数字を捏造してはいけません。また、実際にキャプチャしていない画面を描いてはいけません。
レンダリング
スライド間に動きをつけて、無音の横向き動画を1本(たとえばmp4)レンダリングします。すべてのフレームはスライドそのものとし、画面全体に表示します。フレームはスライドから作成し、画面を録画して作ってはいけません。各スライドは、追加した単語3語につき少なくとも1秒、読めるだけの長さで表示します。スクリーンショット内の単語は数えません。動画を埋め込む前に、レンダリング済みファイルから各スライドのフレームを1枚ずつ確認し、そのファイルでの表示時間に対して追加した単語数を数えます。その時間内に読めないスライドがあれば修正して再レンダリングし、再度確認します。