explain-with-video について
変更点を短いアニメーションで説明するスキルです。プロジェクトの変更を視覚的に伝える用途を想定し、動画ファイルではなく、編集・検索可能なHTML/SVGアニメーションを標準で生成します。
主な機能
- 01約60秒の説明アニメーション
- 02動くビジュアルを含む4~7章
- 03テキストの検索とコピー
- 04プレーヤー操作と字幕
- 05動画ファイルへの任意出力
活用シーン
- 01プロジェクトの変更点を視覚化
- 02短いアニメーションで変更を説明
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ kjetilhartveit/ kjetils-skills --skill explain-with-videoインストール後、Claude Code で/explain-with-videoを入力して読み込まれたか確認します。
詳細
動画で説明
大きな動画風プレーヤーで再生する、約60秒の短く簡潔なアニメーション解説です。デフォルトでは動画ファイルではなく、ライブHTML/SVGアニメーションです。テーマに沿って表示され、テキストを検索・コピーでき、編集時に再レンダリングは不要です。
このスキルを使う場面
- ユーザーが、変更内容を動画で視覚的に説明するよう求めた場合。
- オーケストレーターが、変更内容を動画で視覚的に説明するために使う場合。
動画
- 約60秒で、テンポよく進みます。4~7章で構成し、各章では1つの要点を1つの動くビジュアルで伝えます。
- 大きなステージを使用します。デスクトップではコンテンツ幅いっぱいの16:9にし、スマートフォンでは縦長のレイアウトに切り替えて、文字を大きくします。
- ステージの下の帯に、キャプションを実際のテキストとして表示します。
- ステージはすっきり保ちます。動画内やスクラバー上に、章のラベル、タイムスタンプ、ツールチップを表示しません。
- プレーヤーの操作機能:再生/一時停止(Space)、スクラバー、再生速度、キャプションの切り替え、全画面表示。
- 再生前に、空のステージではなく、意味のあるポスターフレーム(最も印象的なフレーム)を表示します。一時停止すると、常に見やすくすっきりしたフレームが表示されます。
プレーヤーの下
- プレーヤーのすぐ下に章の名前を横一列に表示します。クリックするとその章に移動し、再生中の章をハイライトします。
- 続いて、コンパクトな詳細エリアを設けます。内容が分かる名前を付けた
ev-moreトグルをいくつか配置し、ビジュアルコンテンツ(ハイライト表示したコード、チップ、コンパクトな表)を含めます。小さくまとめます。
作成方法
explainer-kitスキル(テーマトークン、ev-more、コードブロック)を使って作成します。- すべてのフレームを、時間だけをもとに全体の画面を設定する1つの関数
render(t)で描画し、requestAnimationFrameで動かします。これにより、シーク、再生速度の変更、ポスターフレームを簡単に実現できます。 - ユーザーがページ外で共有するファイルを必要とする場合に限り、実際の動画ファイルをレンダリングします(例:Python PILでフレームを作成し、ffmpegにパイプで渡します)。
コメント
Markdown 対応