Communitygithub.com

screen-demo

任意のWebサイトやWebアプリのコードから、完成度の高いデモ動画(とGIF)を作成します。Claudeがページを確認し、ツアーを計画。スクリプトがChromium上で滑らかなカーソル、実際のクリック、タイピング、イージング付きスクロールを再生し、重要な部分をズームアップ、ハイライトリング、キャプション、タイトルカード付きの1920×1080(または縦長、正方形)動画をレンダリングします。

screen-demo とは?

このスキルは、ユーザーが指定したURLのWebページまたはアプリを、自動化されたデモ動画(およびGIF)に変換します。開発者は「サイトのデモ動画を作って」「アプリを録画して」「このページのスクリーンキャプチャ動画を」といった要望に対して、このスキルを活用できます。 動作の流れは以下の通りです。まずClaudeがページを解析し、操作手順(ツアー)をJSONで設計します。次にPlaywrightとChromiumを使って実際のブラウザ操作(クリック、タイピング、スクロール)を30fpsでキャプチャ。最後にffmpegで動画を編集し、ズームイン、ハイライトリング、キャプション、タイトルカードを付与します。フォーマットは横長(16:9)、縦長(9:16)、正方形から選択可能で、GIFの同時生成にも対応します。 主な対応プラットフォームはClaude Code(コマンドライン経由)で、Python、Playwright、ffmpegの事前セットアップが必要です。セキュリティ面では、個人情報の入力や購入・送信操作を禁止するルールが組み込まれており、安全なデモ制作が可能です。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

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

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

ドキュメント

screen-demo は何をしますか?

URLをデモ動画に変換します。あなたはディレクターです:ページを確認し、ツアーをJSONで記述し、スクリプトがそれを再生し、ページ自身のフレーム(デスクトップはキャプチャしません)を取り込み、動画を編集します。スクロール、カーソルの動き、タイピングは30fpsで1フレームごとにキャプチャされるため、重いページでも滑らかです。クリックや読み込み後にページ自身が行う動作は、ライブスクリーンキャストから取得されます。

セットアップ(一度だけ)

  1. Python 3.10以上、Pillowと最新のPlaywright:python -m pip install -U playwright pillow、その後python -m playwright install chromium。
  2. PATHにffmpegを追加(winget install ffmpeg、brew install ffmpeg)。

確認:python tests/selftest.py(ローカルページ、ネットワーク不要、約1分)。

ワークフロー

  1. 動画の用途を尋ねる: URL、表示したい2〜4個のこと(ヒーロー、機能、価格、サインアップフロー)、フォーマット(YouTubeやREADME用のlandscape 16:9、ShortsやReels用のvertical 9:16、square)、GIFが必要かどうか。ユーザー自身のサイトまたはアプリ、あるいは公開されていて表示が許可されたページのみ。
  2. ページを確認する: python scripts/demo.py inspect URL WORK [--format vertical]。すべてのWORK/page-N.jpg(ビューポートサイズにスライスされたページ、クリック可能な要素が赤い番号で囲まれている)とWORK/elements.txtを読みます。Cookieバナーやポップアップはここに現れます:ツアーの最初のステップでそれを閉じます(「拒否」または「閉じる」ボタン)。
  3. WORK/tour.jsonを記述する(フォーマットはreferences/tour-format.mdを参照):タイトルカード、続いて短いステップ。良いツアー:製品の説明を伝えるキャプション、最初に見る価値のあるものへのスクロール、その部分へのズーム、製品が動作していることを示すクリックまたはタイピング、結果へのハイライト、アイデアごとのキャプション。15〜40秒。ターゲットはinspectの番号(#12)、またはcss=...、text=...。
  4. 録画する: python scripts/demo.py record WORK/tour.json OUT [--gif]。ツアーを再生し、失敗した各ステップを表示し、OUT/demo.mp4(およびOUT/demo.gif)をレンダリングします。
  5. 完了前にOUT/keys.jpgを確認する(各ステップのフレーム):間違った場所へのズーム、フレームのポイントを覆うキャプション、失敗したステップ(要素が移動したか非表示)、まだ邪魔なバナー。キャプション、ズーム、タイトルカードのみ変更する場合は、OUT/tour.jsonを編集し、python scripts/demo.py render OUT [--gif]を実行します(再録画は不要)。それ以外の場合は再度録画します。
  6. 納品する: demo.mp4(およびGIF)のパス、長さ、表示するアイデアごとに1行。

ルール

  • パスワードでログインしない、パスワードやカード番号を入力しない(スクリプトはパスワードおよび支払いフィールドを拒否します)、購入・送信・投稿・削除をしない、他人の個人データでフォームを送信しない。ログインが必要な領域のデモには、ユーザー自身がテストアカウントのページを提供する必要があります。
  • ユーザーが別途指示しない限り、Cookieバナーは拒否します(最小限のデータ)。
  • キャプションは短く(3〜8語)、キャプションごとに1つのアイデア。動画自体の動きが残りを伝えます。
  • サイトを尊重する:ユーザーが表示を許可していないページのツアーは作成しない。

例

ユーザー:「https://example.com のランディングページの20秒デモをREADME用に作って、サインアップを表示して」

あなたはinspectを実行し、3枚のスライスを読み、Cookieバナー(#2「すべて拒否」)、ヒーロー、「試してみる」フィールド(#9)、価格カード(#21)を確認。ツアーを作成:タイトルカード、#2をクリック、キャプション「自動で書かれるノート」、#9に入力、#10をクリック、結果をハイライト、キャプション「永久無料」、#21にスクロール、ズーム。--gif付きで録画、keys.jpgを確認、価格が適切にフレームに入っているズームを確認し、demo.mp4(21秒)、demo.gif(3 MB)、4つのアイデアと共に回答します。

関連スキル