record-and-replay

Installation
SKILL.md

Record & Replay

Record & Replay lets ChatGPT learn a user-demonstrated macOS workflow and turn it into a reusable skill. Use it when the user asks you to watch them perform a task, record a workflow, or create or refine a skill from their demonstration.

Recording Workflow

  • Use event_stream_start when the user is ready to begin recording.
  • After event_stream_start succeeds, do not sleep, poll, or wait in a loop for the user to finish. End your turn and let the user tell you when they are done recording.
  • Use event_stream_status only when the user asks for status or returns after recording; do not use it to poll while waiting.
  • Use event_stream_stop when recording is complete.
  • When the user says they are done recording, read the returned metadataPath and eventsPath from disk with normal filesystem tools and inspect the captured events before responding.
  • When the user says they cancelled recording, you may read session.json if needed to confirm that its endReason is recording_controls_cancelled; acknowledge the cancellation without creating or updating a skill.
  • Before creating or refining a skill, check whether the recording and the user's request clearly establish the reusable workflow, its intended outcome, and which demonstrated values should become skill inputs rather than fixed details. If anything is ambiguous, proceed with the most reasonable interpretation rather than stalling; you can surface assumptions in the summary.
  • Otherwise, if the recording contains enough information to identify a reusable workflow, create or refine a skill for that workflow by default even if the user did not explicitly ask for one; do not stop after providing a summary, replay plan, runbook, or suggestion to create one.
  • The MCP server does not expose event-stream contents directly.

Concurrent Recording

Record & Replay supports one active recording at a time. If event_stream_start reports an active recording, do not restart it. Explain that another recording is already in progress and ask whether the user wants to use that active recording or wait until it is stopped.

Installs
1
First Seen
Aug 24, 2026