record-ui-walkthrough

Installation
SKILL.md

Record one short, paced video of a running web app that proves a few named claims, each one shown, highlighted, and captioned. The video is 1280×800 H.264, small enough to attach to a GitHub PR.

Work in a scratch dir outside the repo. A caller (the pr skill, say) may hand you one; otherwise use SCRATCH="${TMPDIR:-/tmp}/walkthrough-<slug>". Skill files live at ~/.agents/skills/record-ui-walkthrough/; expand references/ and scripts/ from there. The app must already be running and showing the state to record; starting it is the caller's job.

Steps

  1. Probe. Run check-kit.py capture video per setup. Done when: requiredReady is true. Voice is optional; a missing voice stack means a silent render.

  2. Shot list. Write $SCRATCH/shot-list.json per Shot list, then run validate-video.py shots "$SCRATCH". Done when: the gate passes and every claim is something a viewer could see happen.

  3. Explore. Open the session per cli, reach each surface, and confirm it is served. Generate a stable locator for every target. Done when: every surface is reachable and served, and every target has a locator from generate-locator.

  4. Preflight. Dry-run every surface per recording. Done when: the preflight gate passes.

Installs
9
First Seen
Oct 10, 2026