mcpField
E
explain-with-section-clips

explain-with-section-clips

github.com/kjetilhartveitデザイン・UI282 回インストール1 週間前に更新
リポジトリ

explain-with-section-clips について

グループ化したセクションと短いループ動画で変更を説明するスキルです。クリップの動作、アクセシビリティ、レイアウトを定め、`explainer-kit` と `EV.clip` で視覚的な説明を作成します。

主な機能

  1. 01説明を 3~6 セクションに構成
  2. 02各 5~12 秒のクリップで一つの概念を表示
  3. 03画面外ではクリップを一時停止
  4. 04再生コントロールと進行状況を表示
  5. 05視差効果低減時とサムネイルには終了フレームを表示
  6. 06`explainer-kit` と `EV.clip` でクリップを作成

活用シーン

  1. 01変更内容を視覚的に説明
  2. 02値が段階を経て流れる様子を表示
  3. 03リクエストが停止される仕組みを図示
  4. 04コード変更をセクションごとに提示

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kjetilhartveit/kjetils-skills --skill explain-with-section-clips

インストール後、Claude Code で/explain-with-section-clipsを入力して読み込まれたか確認します。

詳細

セクションクリップで説明する

従来型の、セクションをグループ化したページです。各セクションのビジュアルは、小さなプレーヤーフレーム内で短いループアニメーション(「クリップ」)として表示されます。各クリップでは、1つのアイデアだけを示します。

このスキルを使う場面

  • セクションクリップを使って変更内容を視覚的に説明するようユーザーから求められた場合。
  • オーケストレーターが、セクションクリップを使って変更内容を視覚的に説明する場合。

セクション

  • 3~6個のセクション。各セクションは、1文の要点 → 1つのクリップ → 2~3行の短い説明 → 内容を示す名前が付いた1つのev-moreトグル(例:「新しいコード · 変更したファイル」)で構成します。
  • 関連情報はトグル内にまとめます。強調表示されたコード、グループ化された項目、ステータスチップ、簡潔な表などを含めます。

クリップ

  • 5~12秒でループし、1つのアイデアを示します。数値が増えていく様子、値が段階を経て流れる様子、リクエストが停止される様子、変更が利用側へ広がる様子などです。
  • 表示されている間だけ再生し、スクロールして画面外に出たら一時停止します。再生/一時停止/再再生の操作ボタンとプログレスバーを用意します。
  • 停止中(再生前、動きを減らす設定時、サムネイル表示時)は、最終フレームを表示します。最終フレームだけで結果が伝わる必要があります。
  • クリップ内のテキストは、スマートフォンでも読みやすくします(デスクトップサイズで13 px以上。狭いフレームでは拡大します)。

作成方法

  • explainer-kitスキルを使ってフラグメントとして作成し、EV.clip(el, {duration, setup, draw})でクリップを描画します。draw(t)は時刻だけからフレーム全体を設定するため、シーク、ループ、ポスターフレームを簡単に扱えます。
  • 各セクションにidとdata-tocを設定し、チャプターリストに表示されるようにします。

コメント