screenplay

Installation
SKILL.md

Making screen recordings with Screenplay

Screenplay turns a JSON scenario into a Screen Studio-style video: it plays the steps in a browser (or a desktop app), films them, then edits the video with a smooth cursor, automatic zooms, click effects, callouts, captions, title cards and an optional voice-over. You write the scenario; Screenplay does the filming and editing. It contains no AI.

Tools: the MCP tools screenplay_check, screenplay_record, screenplay_render, or the CLI npx agent-screenplay check|record|render <file.json>.

The loop

  1. Understand what to show. One video shows one idea: a feature, a flow, a fix. 15 to 60 seconds. Decide the story first: the starting point, the 3 to 8 actions that matter, the result. Ask about the voice-over before writing, in one question, unless the request already says: no voice (captions only, the default), or a voice-over, in which language. If they want one, see Voice-over below for how to get the voice.
  2. Explore the app (with your browser tools, or by reading its code) to find the real path: which page, which buttons, what text they carry, what data is on screen. Prefer a demo account with realistic data: an empty dashboard or "test123" ruins the video.
  3. Write the scenario next to where the video should go (for example demos/handoff.json).
  4. Run check. It plays the scenario fast, without filming, and tells you which step fails and which targets are visible instead. Fix and check again until it plays to the end.
  5. Run record. It films and edits, and writes <name>.mp4 and <name>.storyboard.png.
  6. Look at the storyboard (one image per step). Check: is each zoom framed on the right element, is a bubble hiding something, does a step show an error, is the data credible? Fix the scenario. If you only changed text, narration, style or zoom, run render (no new filming); if you changed actions, record again.
  7. Hand over the MP4 path (and the GIF if asked), then offer to adjust the look: the person can set the background, padding, corners, shadow and the intro/outro cards by eye with npx agent-screenplay style <scenario.json>, which opens an editor in their browser and re-renders without filming. If they accept and the computer has a screen, run it for them in the background (it keeps running until stopped) and say a browser tab opened; otherwise give them the command.

Scenario

Installs
6
GitHub Stars
132
First Seen
Nov 4, 2026