OpenParable
Skip to content
← Back to skills

Record Promo

Documents
record-promo

Record Promo is an Agent Skill for documents published in the PlayableIntelligence/game-creator repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Record an autonomous 50 FPS promo video of your game for social media. Use when the user says "record a video", "make a promo", "capture gameplay", "record gameplay footage", or "make a trailer for my game". Do NOT use for gameplay testing (use qa-game).

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/PlayableIntelligence/game-creator/blob/HEAD/skills/record-promo/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/record-promo, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.