Communitygithub.com

dsonders/claude-skills

ナレーション付きのトレーニングビデオやウォークスルービデオ(対応する注釈付きスライドとPDFを含む)を、実際のTenthGearアプリを使用して制作します。まずデザインキャンバス上でストーリーボード(キーフレーム、コールアウト、音声トラック)を作成し、Daveがその場で編集します。その後、実際のアプリから静止画や映像をキャプチャし、OpenAIのテキスト読み上げ機能でナレーションを生成し、ビデオを組み立てます。トレーニングビデオ、はじめの一歩ガイド、クイックスタート、ハウツービデオ、ウォークスルー、技術者やアドバイザー向けの注釈付きスクリーンショットの作成、または既存のトレーニングビデオの改訂を求められた場合に使用します。

claude-skills とは?

このスキルは、TenthGearアプリを実際に使用したトレーニングビデオとそれに対応する注釈付きスライド・PDFを生成するためのワークフロー全体を提供します。特徴的なのは「ストーリーボードファースト」のアプローチで、実際のビデオ制作に入る前に、Daveがデザインキャンバス上でストーリーボード(各カードの見出し、ヘルプテキスト、キーフレーム、コールアウト、ナレーション文)を編集し、承認します。その後、実際のアプリから静止画やクリップをキャプチャし、OpenAIのgpt-audio-1.5モデルを使用したテキスト読み上げでナレーションを生成、スクリプトを使ってスライドとビデオを組み立てます。このスキルはClaude Code環境向けに設計されており、すべての成果物が単一の`storyboard.json`ファイルから生成されるため、一貫性が保証されます。トレーニングビデオの新規作成から改訂まで、一貫した品質と効率的な制作を実現します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsonders/claude-skills/tree/HEAD/video-training

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

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

ドキュメント

ビデオトレーニング:まずストーリーボード、次に実際のアプリを画面表示

トレーニングビデオは、一連の電話画面のようなカードで構成されます。各カードには、見出し、1行のヘルプ、実際のアプリからのコールアウト付きキーフレーム、そして1行のナレーションが含まれます。一部のカードは静止画の代わりにアプリの短いクリップを再生します。同じカードがスライドとPDFとしても提供されます。

すべてを統制するファイルは1つです:storyboard.json。Daveはデザインキャンバスを通じてこれを編集し、すべてのビルドスクリプトがそれを読み込みます。

使用するタイミング

使用する場合:

  • アプリを紹介するトレーニングビデオ、はじめの一歩ガイド、クイックスタート、ハウツービデオ
  • 技術者、アドバイザー、部品担当者向けの注釈付きスクリーンショットまたはスライドガイド
  • このスキルで作成されたビデオの改訂(新しい文言、新しいカード、新しいクリップ)

使用しない場合:

  • マーケティングやプロモーションビデオ(トーンとルールが異なります。Daveに相談してください)
  • 製品内で記録される顧客向け点検ビデオ
  • まだ存在しない画面のモックアップ(/visualを使用してください)

原則

  1. 制作前にストーリーボード。 Daveがストーリーボードキャンバスを編集し、完了したと言うまでは、ナレーションも動画の組み立ても行いません。
  2. 実際のアプリで、実際の作業を表示。 実際のスキャン、実際の音声入力、実際に生成されたストーリー。決してモック画面や入力された結果を使用しないでください。
  3. Daveはチャットではなくキャンバス上で指示を出します。 キャンバスを読み取り、その差分を確認します。会話から彼の指示を再構築しないでください。
  4. 承認されたテイクは保持されます。 ナレーションは、文言が変更された行についてのみ再生成されます。Daveがレビューしたバージョンを上書きしないでください。-v2、-v3として出荷します。
  5. Claudeは聞いたり見たりできません。 その旨を毎回の手戻り時に伝えてください。単語は文字起こしで証明し、画像はサンプルフレームで証明し、確認できなかったものを明示します。
  6. 元の状態に戻す。 モードを復元して確認し、再撮影の修理依頼はクローズします。

最初に読むもの

  • /Users/davidsonders/ro-bot/shared/product-facts.md および shared/brand.md:名前、数、禁止ワード。emダッシュなし、絵文字なし、「TenthGear」は一語。視聴者に見えるもの、聞こえるものでは「single player」や「multi-player」とは決して言わないでください。
  • このフォルダ内の reference.md:技術的な落とし穴。それぞれすでに一度は経験済みです。
  • デザインキャンバスに関するメモリー:reference_design_canvas_mechanics、reference_design_canvas_roundtrip、reference_design_canvas_entity_crash。

ファイルの保存場所

内容場所
ビデオのプロジェクトフォルダ/Users/davidsonders/ro-bot/training-videos/<slug>/(セッションと共に消えるスクラッチパッドには絶対に置かない)
唯一の信頼できる情報源<project>/storyboard.json
キーフレーム、クリップ、ナレーション<project>/frames/、footage/、narration/
ビルド成果物<project>/out/
Daveが受け取る場所~/Desktop/<Title>/
作業例training-videos/story-writer-getting-started/ およびこのフォルダ内の examples/story-writer/

スクリプトはこのフォルダ内の scripts/ にあります。最初の引数としてプロジェクトフォルダを取ります。

ワークフロー

以下の手順のTODOリストを作成し、順番に進めてください。

ステップ0:依頼内容を確定する

リクエストから以下の情報を見つけます。不足しているものだけを、推奨事項を先に述べて1つの質問で尋ねてください。

決定事項デフォルト
誰が見るのか、どの役割か技術者 (Technician)
電話かデスクトップか電話、390 x 844
どのフローを、最初から最後までDaveの概要
ストアとワークフローモードDaveに確認。ステップ2を参照。
静止画のみか、静止画+クリップか画面が動くところではクリップ:録画、読み込み、開閉
尺2分30秒以内

ステップ1:デザインキャンバス上でストーリーボードを作成する

これはDaveが最初に見るものであり、彼がスクリプトとコールアウトを編集する場所です。

  1. プロジェクトフォルダを作成し、必要な小道具をレンダリングします(props/render-paper.mjs がサンプルの紙の修理依頼書を作成します)。

  2. キーフレームのためにフローを下見します。 キーフレームは実際のアプリから取得するため、このステップではキャプチャ実行(ステップ2とステップ3、静止画のみ)が必要です。examples/story-writer/capture-stills.mjs をプロジェクトにコピーし、フローを書き換えます。先に進む前にすべてのフレームを確認してください。

  3. storyboard.json をドラフトします。 視聴者が行う操作ごとに1カード。形式は以下の通り:

    { "id": "write-story", "part": 2, "img": "10-write-story",
      "title": "[[Write Story]] をタップ",
      "body": "AIライターがあなたのメモをレビューし、3Cを自動生成します。",
      "boxes": [[183, 400, 191, 44]], "arrow": [162, 768],
      "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "クリップの内容" },
      "narration": "準備ができたら、Write Storyをタップしてください。" }
    

    boxes と arrow は電話画面のピクセル単位です。キャプチャは各コントロールのボックスをフレームの横に書き込みます。[[Label]] はボタンチップを描画します。最初のドラフトから以下のスタイルルールに従ってください。

  4. キャンバスを作成します。 アーティファクトツール:quickstart に design 意図を指定して実行し、返された type_url とタイトルを指定して公開します。URLを <project>/storyboard/artifact.json に保存します。

  5. キーフレームをキャンバスにアセットとしてアップロードします(JPEG、高さ1688ピクセル。スクラッチパッドにステージングして1回の呼び出しで送信します)。返された各 /_blob/... URLを artifact.json の assets の下に、フレーム名をキーとして記録します。

  6. 生成して公開します。 node scripts/storyboard-canvas.mjs <project> で storyboard/project/ を書き込みます。そのフォルダをスクラッチパッドにコピーして公開します:canvas.json を file_path として、すべての .dc.html を files として。

  7. リンクをDaveに渡して停止します。 彼に伝えてください:カードの単語は再入力可能、各カードの下の青いメモは音声トラック、黄色いコールアウトはドラッグ可能、その他のメモは自由に追加可能。制作は開始しないでください。

  8. 編集内容を収集します。 アーティファクト read を paths(インデックスとすべてのアートボード)と out_dir を指定して実行し、その後 node scripts/storyboard-harvest.mjs <project> <out_dir> を実行します。レポートを平易な言葉で彼に読み上げ、彼が追加したメモに対応し、その後 --write を付けて再実行します。

  9. もう1ラウンド必要ですか? project/canvas.json を読み戻し、--live <そのファイル> を付けて再生成し、再公開します。ライブインデックスから開始しない公開は拒否されます。

ステップ2:ストアを借りる

アプリはビデオで表示するモードでなければなりません。テストストアのみ使用可能です。

ストアID通常モード注記
Summit Auto Group (デモ)demo-dealershipチームワークフローDaveの見込み客向けデモ。ログイン:[email protected] (技術者)、marcus@ (アドバイザー)、priya@ (部品)。最初のビデオで使用。
Test Dealership 1mlTaPo12wbpUtJB9GXJMチームワークフロービルドセッションと共有。多くの場合ビジー。
  1. ListAgents を実行し、次に各ピアに SendMessage で問い合わせます:そのストアを使用しているか、モードが必要か?回答を待ちます。ピアが必要とする場合は、別のストアを使用するかDaveに尋ねます。
  2. まずモードを読み取ります:アプリフォルダから NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id> を実行します。
  3. キャプチャの実行中のみ、キャプチャと復元の同じコマンドチェーン内でモードを変更します。その後、再度読み取って確認します。
  4. 顧客のストアには絶対に触れないでください。テストアカウントの設定を変更しないでください。

ステップ3:キャプチャ

  • 静止画: dpr: 3。カードごとに1フレーム。画面が落ち着いてから撮影します。
  • クリップ: dpr: 2、vt.recorder を使用。各クリップは静止のビートで開始し、指のマーカーを表示してから操作します。marks.json を読んで footage.runs を選択します。
  • 音声入力は実際のもの。 vt.dictation で録音されたクリップを擬似マイクに再生します。アプリがそれを録音して文字起こしします。すべての文字起こしを印刷して読んでください:文字起こしは数字やブランド名を書き換えることがあります。
  • 再撮影には新しい修理依頼書が必要です。番号を順に付け、各IDを created-ros.txt にリストします。

ステップ4:スライド

node scripts/build-slides.mjs <project> で out/slides/*.png、PDF、およびビデオに必要なレイヤーが書き込まれます。すべてのカードのコンタクトシートを確認します。コールアウトが指すものを隠していないか確認します。

ステップ5:ナレーション

cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>

音声 ash、モデル gpt-audio-1.5(以前の gpt-4o-mini-tts から移行。OpenAIは2027-01-06にこれを廃止予定)。文字起こしがカードの文言と一致しないテイクは再試行され、それでもダメなら拒否されます。Daveはこの音声を承認し、Macの内蔵音声はロボットっぽいとして却下しました。アプリのOpenAIキーを使用し、1ビルドあたり数セントのコストがかかります:新しいビデオの概要でその旨を伝え、支出が驚きとならないようにします。DRY=1 で再生成されるものをリスト表示します。

耳で聞くためのナレーションを書いてください:「アール オー」「スリー シーズ」「テンスギア ドット エーアイ」。各部分は最初のカードでアナウンスします。

ステップ6:ビデオ

node scripts/build-video.mjs <project>。速度は1.25倍(QuickTimeの「Fast」)、Daveが承認したペースです。クリップのあるカードは、ナレーションとクリップのうち長い方の時間だけ再生されます。

ステップ7:検証し、検証できなかったことを伝える

  1. check-audio.mjs でビデオを文字起こしし、各カードをスコアリングします。すべての LOOK 行を読んでください。
  2. クリップや矢印のある各カードから1フレームを抽出して確認します。
  3. 手戻り時に、明確に伝えてください:聞いていない、最後まで見ていない。

ステップ8:納品

ビデオ、PDF、out/slides/ を ~/Desktop/<Title>/ にコピーします。以前のバージョンは保持します。尺、変更点、Daveが気づくかもしれない事項(クリップ内の異なる修理依頼番号、フッテージ上に重なったコールアウトなど)を伝えます。

ステップ9:クリーンアップ

  • ストアモードを復元し、読み戻して確認します。
  • node scripts/close-ros.mjs <project> <email> <org-id> で再撮影をクローズします。修理依頼の削除はDaveの判断です。
  • メッセージを送ったピアに、ストアが空いたことを伝えます。

スタイルルール(Dave、2026-09-29)

ルール例
視聴者がタップするボタンはボタンとして描画する[[新規RO]] をタップ
パートヘッダーは短く、「/3」のような表記はしないパート2:保証ストーリー
表紙にステップ数は入れない
1ステップにつき1カード。1つの判断を示すカードは統合するレビューと保存は1カード
自明なポイントのカードは省く原因と修正の読み上げ
誰が何を使って操作するかを明記する「メモを追加する」ではなく「音声メモを追加する」
画面上の2つのものが該当する可能性がある場合、どちらかを指す緑のボタンに矢印
アプリ内で動くものはビデオでも動かす波形、スピナー、カードの開閉
現場用語を使用するRO、ライン、ストーリー、3C、CP

Daveはスライドの編集をPDFのページ番号で指定します。ページ1は表紙なので、「pg 7」はステップ6です。各編集を適用する前に、ステップ名で言い換えてください。

成功基準

  • Daveがストーリーボードキャンバスを編集し、その編集内容が推測ではなく収集されたこと
  • すべてのフレームとクリップが、ビデオで説明するモードの実際のアプリであること
  • スライド、PDF、ビデオがすべて同じ storyboard.json から生成されていること
  • ナレーションが文字起こしで確認され、不明瞭な行が特定されていること
  • 手戻り時に、聞いていない箇所や見ていない箇所が明記されていること
  • ストアモードが復元され確認済みであること。再撮影の修理依頼がクローズされていること
  • プロジェクトフォルダがスクラッチパッド外に保持されていること

関連スキル

  • /visual:まだ存在しない画面のモックアップ用
  • /app-testing:このスキルが借用するテストアカウントとライブパスハーネス用
  • /compound:キャプチャ中に製品のバグや新しい落とし穴が発見された場合に使用

関連スキル