mcpField
R
record-promo

record-promo

github.com/playableintelligenceMarketing & growth350847 installsUpdated 22w ago
Repository

About record-promo

record-promo is a skill that automates recording and converting gameplay footage from Phaser games into promotional video. It guides setup, game-specific capture scripting, and preview verification.

Key features

  1. 01Checks development server and capture dependencies
  2. 02Generates game-specific Playwright capture scripts
  3. 03Patches failure paths and simulates game controls
  4. 04Converts recordings to MP4 with FFmpeg
  5. 05Creates and previews a thumbnail

Use cases

  1. 01Recording gameplay clips for social media
  2. 02Capturing repeatable game footage without manual input

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/playableintelligence/game-creator --skill record-promo

After installing, type/record-promoin Claude Code to confirm it loaded.

Details

From the project README

Record Promo Video

Autonomously capture smooth, high-FPS gameplay footage of your Phaser game — ready for TikTok, Reels, Moltbook, or X. No human input needed during recording.

Instructions

Record a promo video of the game at $ARGUMENTS (or the current directory if no path given).

1. Pre-checks

Verify these are available:

  • Dev server: Check if one is already running (curl -s http://localhost:3000/). If not, start one with npm run dev in the background. Note the port.
  • Playwright: npx playwright --version. If not installed: npm install -D @playwright/test && npx playwright install chromium
  • FFmpeg: ffmpeg -version | head -1. If not found, tell the user to install it (brew install ffmpeg on macOS) and stop.
2. Generate the capture script

Load the promo-video skill for the full technique reference.

Read the game's source files to understand:

  • src/scenes/GameScene.js — find death/failure methods to patch out
  • src/core/EventBus.js — event flow
  • src/core/Constants.js — input keys, game dimensions
  • src/main.js — verify __GAME__ and __GAME_STATE__ globals are exposed

Create scripts/capture-promo.mjs adapted for this specific game:

  • Patch out ALL death/failure code paths
  • Generate input sequences matching the game's actual controls
  • Include entrance animation pause (1-2s)
  • Default viewport: 1080 × 1920 (9:16 mobile portrait)
  • Default duration: 13s game-time
3. Copy the conversion script
cp <plugin-root>/skills/promo-video/scripts/convert-highfps.sh <project-dir>/scripts/
chmod +x <project-dir>/scripts/convert-highfps.sh
4. Run the capture
mkdir -p output
node scripts/capture-promo.mjs --port <port>
bash scripts/convert-highfps.sh output/promo-raw.webm output/promo.mp4 0.5
5. Verify and preview

Extract a thumbnail at the 5-second mark and show it to the user:

ffmpeg -y -ss 5 -i output/promo.mp4 -frames:v 1 -update 1 output/promo-thumbnail.jpg

Read the thumbnail image and display it. Report duration, frame rate, and file size.

Example Usage

/record-promo examples/flappy-bird

Result: Patches out death → generates input sequence for the game's controls → captures 13s of autonomous gameplay at 1080x1920 (9:16) → converts to 50 FPS MP4 → output/promo.mp4 ready for TikTok/Reels.

Tell the user:

Promo video recorded! 50 FPS, mobile portrait (1080×1920).

File: output/promo.mp4

Post it to TikTok, Reels, or X to drive traffic to your game.

Comments

Markdown supported