Communitygithub.com

Playgama/ゲーム開発スキル

Webゲームのプロモ動画、トレーラー、開発記録、または「どうやって作ったか」動画を、ゲーム独自のビジュアルで作成。Playgama AIのロゴスティングで始まり、実際のゲームプレイをコマ撮りで収録、実際のプロンプトやエージェントのステップをオンスクリーンカードで表示、ナレーション、音楽、エンドカードを追加。ゲームの色、フォント、UIをそのまま使用。

ゲーム開発スキル とは?

このスキルは、Playgama向けのWebゲームに関する動画制作を支援します。ゲーム開発者がYouTube、Shorts、TikTok、Reels、ランディングページ、Playgamaのリスティングなどに使用する動画(トレーラー、開発記録、ショート動画など)を作成したい場合に使用します。特に、AIエージェントで開発されたゲームや、Playgama MCP、Playgama Bridge SDKを通じて公開されたゲームに最適です。動画はゲームの色、フォント、UIをそのまま継承し、Playgamaのロゴ(3秒間のスティングとコーナーバグ)とリンクのみを追加します。このスキルは、実際のゲームプレイをコマ撮りで収録するスクリプト、ナレーション生成(ElevenLabs、OpenAI、Gemini、Cartesia対応)、ゲームのパレット抽出、テンプレートベースの編集・レンダリング(HyperFrames使用)など、動画制作の全工程をカバーしています。また、ストーリー・スクリプト作成、ゲームのルック&フィールの取得、フィルミング、編集、レンダリングに関する詳細なリファレンスも提供します。ユーザーが「トレーラーを作って」「ゲームプレイを録画して」「ゲームのショート動画を」「どうやって作ったか動画を」と言った場合にも、このスキルが最適です。

対応~Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Playgama/gamedev-skills/tree/HEAD/skills/playgama-game-video

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

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

ドキュメント

ゲームの動画制作

Playgama用のゲーム動画はこのように作ります。動画はPlaygamaではなく、ゲームそのもののように見えます。ゲームの色、フォント、パネル、サウンドを使用します。Playgamaはロゴ(先頭3秒のスティングとコーナーの小さなバグ)とリンクを追加します。残りの作業は3つの場所にあります。ストーリーは真実で具体的、ゲームプレイはきれいに撮影され、最初の1秒で次の1秒を見る価値を生み出します。

バンドルファイル:

ファイル説明
assets/playgama-ai-logo.svg, .png公式Playgama AIロゴ(591×133):紫色のピル型にplaygamaワードマーク、その隣にグレーのボックスに「AI」が切り抜かれています。PNGは4倍サイズ、透明
assets/template/HyperFramesのスタータービデオ、1920x1080:スティング、3つのゲームプレイスロット、タイトル、エンドカード、音楽、音声トラック。上部のテーマブロック1つでゲームのルックを保持
assets/sting-preview.mp4イントロアニメーションの表示例。ゲームのビデオが始まるプレースホルダーに引き継ぎます
assets/sting.htmlイントロアニメーション単体、プレーンCSS(7 KB、ライブラリ不要):任意のページやビデオツールにドロップ可能
assets/playgama-ai-sting.html同じアニメーションをレビューページとして、再生、速度、スクラブコントロール付き。タイムラインと色が明示されています。ブラウザで開いてゲームのスクリーンショットをドロップすると、ゲーム上にロゴが表示されます。デザイナーに渡すことも可能
scripts/film.mjs, scripts/vclock.js任意のWebゲームをフレームごとに撮影し、スムーズなMP4に任意のサイズで出力
scripts/doctor.mjs, scripts/new-video.mjsマシンをチェックしてインストールすべきものを表示。ビデオのフォルダ(テンプレート、gsap、puppeteer)を作成
scripts/palette.mjsゲームが使用する色をスクリーンショットからサンプリング。コードにテーマがない場合に使用
scripts/voice.mjsナレーション:ElevenLabs、OpenAI、Gemini、Cartesia(または無料のドラフト音声)から取得。耳で選ぶためのページと、音楽を下げた音声トラック
references/story-and-script.mdフォーマット、実際のセリフ例を含むビートシート、オンスクリーン素材のルール
references/game-look.mdゲームのルックを取得する方法:色、タイポグラフィ、パネル、モーション、サウンド、テンプレートのテーマ
references/filming.mdテイクの撮影方法:準備、セットアップ、フレームごとのスクリプト、瞬間の選択、最初のフレーム
references/voice-and-music.mdナレーション(テキスト読み上げまたは自分の声)、「Playgama」の発音、テイクの確認、音楽レベル
references/edit-and-render.mdHyperFramesでの編集:テンプレート、カード、縦型カット、チェック、レンダリング、レビュー

必要なもの

macOS、Linux、Windowsで同じように動作します。

  1. node scripts/doctor.mjs でマシンをチェックし、インストールすべきものを表示します。
  2. node scripts/new-video.mjs <folder> でビデオのフォルダ(テンプレート、gsap.min.js、puppeteer)を作成します。以降のコマンドはすべてそのフォルダから実行します。
  • 撮影用: Node 22以上(HyperFramesが必要)、PATHにffmpegとffprobe、puppeteer。film.mjs は実行元のフォルダ、またはスクリプトの隣でそれらを見つけます。ゲームはURLから実行可能である必要があります(開発サーバー、またはビルド上の静的サーバー)。
  • 編集・レンダリング用: HyperFrames(npx [email protected];初回実行で約370 MBのパッケージとヘッドレスブラウザをダウンロード)。
  • ナレーション(自分の声でない場合): ElevenLabsのキー、または scripts/voice.mjs が対応する別のサービスのキー(references/voice-and-music.md に1度設定)、およびWhisperなどの音声認識でテイクを確認するため。
  • 音楽用: 使用許可のあるインストゥルメンタルトラック。

ワークフロー

この順序で作業します。各ステップが次のステップに情報を渡し、2つの承認ポイントで時間を節約します。

  1. 動画の内容を合意する。 フォーマット、長さ、目標を最初に決めます(以下の表)。動画の目的(プレイヤー向け、ストアページ向け、他の開発者向け、Playgamaのチャレンジやカタログ向け)を尋ねます。
  2. 真実のストーリーを収集する。 実際のプロンプト、タイムスタンプ、コミット、バグ、数値、スクリーンショットを集めます(references/story-and-script.md)。ゲームがAIエージェントで構築された場合、チャット履歴が最も豊富な情報源です。それを読み、時間と正確な引用を記録します。
  3. ゲームのルックを取得する(references/game-look.md):ゲーム自身のファイルから、色、フォント、パネル、ロゴ、音楽、UIサウンドを取得します。テンプレートのテーマブロックに書き込みます。
  4. スクリプトを書き、承認を待つ。 ナレーションのセリフと画面に表示する内容を、1行ずつ書きます。開発者が文言とルックを承認してから、ナレーションを作成します。録音済みのナレーションを言い換えると、再度録音する必要があります。
  5. ゲームプレイを撮影し、スクリーンショットを取る scripts/film.mjs を使用し、配信サイズで行います(以下の「ゲームの画像」と references/filming.md を参照)。スクリプトのビートごとに1テイク、それぞれ数秒間、ゲーム自身のコントロールやデバッグフックを使ってステージングします。
  6. 静止画を作成する ゲームのルックで行います。実際のコードと実際の行番号、実際のプロンプトとエージェントのステップ、Webページ、カバーを使用します。
  7. ナレーションを録音し、音楽を選ぶ(references/voice-and-music.md、scripts/voice.mjs)。人間がナレーションのテイクを聞きます。テキスト読み上げは、どの書き起こしも捉えられない方法で失敗するからです。
  8. テンプレートを使って編集・レンダリングする(references/edit-and-render.md)。チェックを実行し、レンダリングし、数秒ごとにフレームを抽出して、すべてを確認してから完了とします。
  9. パッケージ化する: サムネイル(1280x720、ゲームのベストフレーム、ゲームのフォントで最大4つの大きな単語)、タイトル、ゲームのリンク付きの説明文。

最初にフォーマットを選ぶ

動画形状長さ開始
ショート / Reels / TikTok9:16、1080x192015~35秒最初のフレームにゲームプレイ;ロゴは小さなコーナーバグのみ
トレーラー / プロモ16:9、1920x108030~90秒スティング(3秒)、その後ベストなゲームプレイ
「どうやって作ったか」ストーリー16:93~6分フックとなるセリフ付きのゲームプレイ、その後スティングまたはタイトル
チュートリアル(「Playgama MCPで公開する」)16:91~3分/パートスティング、その後結果を先に、手順は後

ショートは最初の1秒で決まります。視聴者はそのまま見るか、スワイプして離れます。フルスクリーンのゲームプレイで始まり、一目でわかるショートは、読むべきもの(長いコメントカード、ゲームメニュー、チャットボックス)で始まるものよりはるかに多くの視聴者を維持します。そのため、ショートはスティングやテキストで始めてはいけません。

ゲームのルック

動画はゲームのように見えます。プレイしたことのある人なら、どのフレームを見てもそれとわかるはずです。ルックはPlaygamaではなく、ゲーム自身から取得します(references/game-look.md):

  • 色 UIとコードから:背景、パネル、テキスト、ボタン、ハイライト。コードにテーマがない場合は、scripts/palette.mjs でメニューやHUDからサンプリングします。
  • タイポグラフィ: すべてのフォントがゲームに一致し、コードフォントも含みます。
    • タイトルはゲームのタイトルフォントまたはロゴフォント、ラベルとプロンプトはUIまたはテキストフォントを使用します。
    • コードとツールコールは、ゲームの精神に沿った等幅フォントを使用します。ピクセルアートにはピクセルフォント、ダーク/レトロゲームにはタイプライターフォント。
    • テンプレートのDM Monoはプレースホルダーのみです。
  • パネルとボタン: ゲームのパネルの形をしたカード、エンドカードのボタンはゲームのメインボタン、ゲーム自身のアイコンとロゴ。
  • モーションとサウンド: ゲームのUIと同じように動かします(バウンス、静か、またはピクセルステップ)。ゲーム自身の音楽とUIサウンドを優先して使用します。
  • 黒いスライドではなく、画像の上にカードを置く。 プロンプトやステップはゲームの暗くしたフレームの上に、タイトルはゲームプレイの下の方に、ゲームの背景色で下部を暗くして配置します。名前だけのカードよりも、実際の画像を並べる方を優先します。

色、フォント、パネル形状は、テンプレートのスタイルの先頭にある1つのテーマブロックにまとめます。

ゲームの画像

このキットにはゲームの映像は含まれていません。ゲームのすべての画像は、開発者自身のゲームから、あなたが scripts/film.mjs(references/filming.md)を使って撮影します。これには動画、サムネイル、カードの背景フレーム、レビューページが含まれます。

  • クリップ: ビートごとに1テイク。例: node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6
  • スクリーンショット: 同じコマンドに --still <seconds> を付けると、その瞬間の1枚のPNGを書き出します。ステップでゲームの画像が必要なときにいつでも取得します。
    • メニューとHUD(ルックを読み取るため scripts/palette.mjs で使用);
    • プロンプトカードやタイトルの背景フレーム;
    • サムネイルとエンドカード;
    • ゲーム上のスティング(コーナーバグがHUDと重なっていないか確認)。スクリーンショットを assets/playgama-ai-sting.html にドロップするか、最初のクリップをテンプレートに入れて npx [email protected] snapshot . --at 3.5 --describe false を実行します。
  • 縦型カット は1080x1920で撮影し、ゲームのカメラをそれ用にリフレームします。
  • ゲームがここで実行できない場合(ネイティブビルド、ログイン必須、オンライン専用ゲーム)、開発者に配信サイズの画面録画とスクリーンショットを依頼します。カーソルや通知が画面に表示されていないものに限ります。他のゲーム、ストアページ、このキットのサンプル画像で埋め合わせしないでください。

Playgamaが追加するもの

ロゴとリンクのみ。Playgamaの紫とダークプレートはロゴとスティングに属し、動画には属しません。

  • ロゴ は assets/playgama-ai-logo.svg、公式ファイル:紫色 #9747ff のピル型に白いワードマーク、グレー #d2d2d2 のボックスに「AI」が切り抜かれています。
    • そのまま使用します。色を変えたり、引き伸ばしたり、エフェクトを追加したり、間隔を変えたり、再描画したりしないでください。
    • 「AI」は穴なので、ロゴの後ろにあるものが透けて見えます。
    • ピルの高さの少なくとも半分のクリアスペースを確保します。
    • コーナーバグとしては、1920フレームで約200ピクセル幅です。ゲームのHUDがそのコーナーにある場合は、HUDを覆う代わりに別のコーナーにバグを移動します(references/edit-and-render.md)。
  • リンク はPlaygama上のゲーム自身のページに送ります。エンドカードと説明文に配置します。

イントロスティング

Playgamaのアイデンティティ。トレーラーの前のパブリッシャーロゴのようなもの。約3秒、assets/template/index.html に既製のものがあります。すべての動画で独自の色とタイミングを維持します。その後はすべてゲームのものになります。assets/sting-preview.mp4 はプレースホルダーに引き継ぐ様子を示しています。開発者のゲームの上で見るには、ゲームのスクリーンショットまたはクリップを撮影します(「ゲームの画像」参照)。

  • 構築: オニキスに柔らかな紫色の光彩。紫色のピルが中央から成長(0.05秒、0.55秒かけて)。白いplaygamaワードマークが左から右へワイプイン(0.42秒)。グレーのボックスがピルの隣にポップイン(0.92秒)、「A」と「I」が切り抜かれる(1.12秒、1.27秒)。光の帯がピルを横切る(1.55秒)。
  • ハンドオフ: ロゴ全体が19%サイズで右上隅に飛び、1920×1080フレームの上端と右端から39pxの位置に移動(2.75秒、0.62秒かけて)。バグとしてそこに留まり、その下でゲームプレイがフェードイン(3.0秒)。
  • パーツ は公式ファイルの形状から240pxの高さで描画されるため、スティングは正確にロゴで終わります。
  • 変更: タイミングは維持します。最初にコールドオープン(ストーリー)を入れる場合は、スティングを後から開始します。テンプレートで S を設定します(references/edit-and-render.md)。9:16カットの場合は、構築を省略し、1フレーム目からコーナーのバグを開始します。

失敗から得たルール

  • 画面には実際の素材のみ。
    • 実際のプロンプト、実際の数値、実際のタイムスタンプ、実際のコードを表示します。
    • 数値を例示的に示す必要がある場合は、表示中ずっと画面上に「EXAMPLE DATA」と明記します。
    • 引用、コメント、プレイヤー数、レビューを決して捏造しないでください。捏造された数値を確認した視聴者は、残りを信頼しなくなります。
  • 画面のプロンプトは開発者の言葉そのもの。
    • 動画の言語に翻訳しますが、言い換えてはいけません。
    • 長いものは「[…]」で切り詰めます。要約してはいけません。
    • エージェントのステップは、実際のツールコールを実際の順序で表示します。例:create_application → start_archive_upload → get_archive_status (PASSED) → publish_sandbox (公開リンク)。
  • 自分のアートだけ。 他のゲームのキャラクター、ロゴ、アートを表示しないでください。自ゲームが「〜に似ている」場合でも、他のゲーム名ではなくジャンル名を挙げてください(「ホラー脱出ゲーム」など)。
  • Playgamaは「プレイガーマ」と発音します。 英語の音声は「プレイゲイマ」と言ってしまうため、修正が必要です(references/voice-and-music.md)。
  • ナレーションのテイクはすべてテキストと照合し、人間が聞いて確認する。 テキスト読み上げは、文の繰り返し、誰も書いていない文の追加、自分の指示の読み上げ、最後の音節の欠落などを、単体では問題なく聞こえるテイクで起こします。
  • 最初のゲームプレイフレームは1秒未満で認識できるもの。メニューやローディング画面ではない。
    • ショートはそれで始まります。トレーラーやストーリーは、スティングまたはコールドオープンの直後にそれに到達します。
    • 最高の瞬間を撮影します。レベルの始まりではありません。
    • ゲームプレイの最初の2秒間のテキストは、最大4つの大きな単語まで。
  • 映像はマシン上に留める。 HyperFramesの snapshot は、GeminiまたはGoogleキーが設定されていると、フレームを説明のためにGeminiに送信します。また、ビデオフォルダ内の .env を読み取ります。すべての snapshot に --describe false を渡し、音声キーはビデオフォルダではなく voice.mjs の共有キーファイルに保持してください。

完了時

開発者には以下を提供します:

  • マスターMP4、およびサイズが大きい場合は小さなプレビュー版;
  • サムネイル;
  • タイトル、説明文(ゲームのリンク、長い動画のチャプター、#playgama)、ピン留めするコメントを記載したテキストファイル。

各ファイルがどこにあるか、そしてまだ開発者が決定すべきこと(投稿時間、まだ聞いていないナレーションテイク、確認できなかったこと)を伝えます。

関連スキル