Menu
Debug a failing demo-machine spec. Use when a demo capture or pipeline run fails with errors.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Generate a polished product demo video from a YAML spec using demo-machine. Use when the user wants to create, run, or update a demo video for their app.
Generate a complete demo-machine YAML spec by crawling a live web app. Give it a URL and description, get a ready-to-run spec.
Automatically fix a broken demo-machine spec by analyzing failure artifacts (screenshots, DOM, error logs). Use when a demo fails after a UI change.
Generate compelling AI narration for every step in a demo-machine spec. Use when a spec has no narration or needs better narration text.
AI quality review of a completed demo run. Analyzes event log, timing, and narration to flag issues and suggest improvements.
Convert an existing Playwright or Cypress E2E test file into a demo-machine YAML spec. Reuses test coverage as demo scripts.
| name | demo-debug |
| description | Debug a failing demo-machine spec. Use when a demo capture or pipeline run fails with errors. |
| argument-hint | ["spec-file-or-error-message"] |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash(node *), Bash(pnpm *) |
Diagnose and fix failures in demo-machine spec runs.
$ARGUMENTS is a spec file path, read and analyze it.$ARGUMENTS is an error message, diagnose the root cause.output/failure.json, output/failure.png, output/failure.html for artifacts.TimeoutError: locator.waitFor or locator.clickwait step before if the element appears after an animation.TimeoutError on page.gotorunner.url matches the actual app URL. Increase runner.timeout. Ensure the dev server is starting correctly.Runner failed or ENOENT errorsrunner.command works in a terminal. Check that dependencies are installed.expected ... to be visible assertion failurewait step or scroll to it first.TTS synthesis failed or audio errors--tts-provider is available. Try --no-narration to isolate the issue. For kokoro, ensure the model downloaded.ffmpeg process errors during renderingdemo-machine doctor to verify ffmpeg is installed. Check that the video file exists in the output directory.node dist/cli.js validate <spec>node dist/cli.js run <spec> --output ./output --no-headlessArguments: $ARGUMENTS