Demo Reel

Use the act of making a demo reel to test the product. A reel shows what a customer would see, shot by shot, on the real thing; shooting it end to end is an acceptance test a mock cannot pass. Every failed shot is a bug to chase, not noise to retry past. The finished reel is the evidence and the promo at once.

references/examples.md tells the story of two reels made this way and the fixes they found.

Pointed here by URL?

If this skill is not installed, fetch it; every script resolves its own paths. The skill lives on the repository's main branch.

DR="$(mktemp -d)/hyperskills"
git clone --depth 1 --branch main https://github.com/hyperb1iss/hyperskills "$DR"
DR="$DR/skills/demo-reel"
bash "$DR/scripts/doctor.sh"        # every failure prints its fix
bash "$DR/scripts/selftest.sh"      # offline proof the toolkit works here

To install it instead: npx skills add hyperb1iss/hyperskills --skill demo-reel, or the hyperskills Claude Code plugin. Installed copies keep the same layout; resolve scripts/, assets/, and references/ relative to this file. Keep takes and renders in the user's project, never in the clone or a RAM-backed /tmp.

The only system dependency is ffmpeg (with ffprobe). Browser capture needs Node 18+ and Playwright with Chromium; scripts/doctor.sh prints the install commands for this machine. Nothing needs ffmpeg's drawtext, and nothing needs Remotion (its license requires a paid company license for for-profit organizations with more than 3 employees).

The loop

1. Write the shot list: what a customer would see, shot by shot. Every shot is an acceptance test with a budget a script can judge (frame time against the target FPS, ack latency, a correct answer).
2. Shoot it on the real thing: the whole product, end to end, nothing mocked.
3. A shot fails: a failed take is a finding. Log it in the failure ledger with the footage and numbers before anything else.
4. A fix lane: one agent owns one failure until the cause is proven.
5. The fix, with evidence: footage and commands a reviewer can rerun.
6. Reshoot: the whole reel again, not only the fixed shot, until a full take passes.

references/method.md has the shot-list format, the ledger, a lane's definition of done, and the reshoot policy.

Steal this

• Write the shot list. Every shot is an acceptance test; a script judges each against its budget.
• Shoot it on the real thing. Composed elements are fine when labeled; faked product behavior is not.
• Build the world the demo needs. Seeded, offline, reproducible demo data, the same every take (references/demo-world.md).
• Cameras on every run. The footage is the evidence and the promo; keep every take.
• Every failed shot starts a lane. Root cause, a fix with evidence, then reshoot.
• Check what the pass measured. A "pass" measured on a half-loaded page is not a pass (references/verify.md).
• A second opinion. Independent verifier agents, a different model family where available.
• Brakes, and a human bar. A sandbox for any agent on camera; a human who can say "not wild about the result".

Pipeline

Each stage has an exit check. Re-enter an earlier stage when one fails.

Commands

Paths are relative to this skill's directory ($DR after the clone above). Run from the user's project with full paths, so takes and renders land there.

scripts/doctor.sh [--out DIR] [--no-browser] [--json]
scripts/selftest.sh                                  # 0 when every case that ran passed

# Browser takes and HTML-rendered titles, captions and timers: deterministic, 4K by default.
node scripts/capture-web.mjs --url URL --seconds 8 --fps 60 --out take.mp4 --json
node scripts/capture-web.mjs --still card.png --at 1200 --url 'assets/card.html#title=Every%20light.'
node scripts/capture-web.mjs --transparent --frames timer/ --seconds 16 \
  --url 'assets/timer.html#map=0:0,1.5:1.5,6:46.5,16:56.5'

# An agent on camera, sandboxed. Sign in once, prove with fixtures, dry-run, then shoot.
scripts/agent-take.sh --login                     # once: a login dir just for takes
scripts/agent-take.sh --prove --allow acme --env ACME_DEMO=1 --skill path/to/skills/acme \
  --tool 'Bash(acme:*)' --tool 'Skill(acme)' --probe 'acme config show' --probe-expect 'no config'
scripts/agent-take.sh --dry-run ...   # same options; prints env, argv and settings
scripts/agent-take.sh --dir ~/example-studio ...  # launches in this terminal

# Review and verify.
scripts/contact-sheet.sh --at 0,2,10.4,15 reel.mp4 review/cuts.png
scripts/verify-mp4.sh --expect-size 3840x2160 --expect-fps 60 --expect-duration 60 --max-freeze 6 reel.mp4

acme stands for the user's product: its CLI, its demo variable, its skill. Prove the sandbox with fixtures and stand-in tools, never by pointing a probe at a real login or real configuration. A maximum freeze longer than the longest deliberate hold catches a reel that stalls.

Every script takes --help, prints JSON with --json where an agent loops on it, and uses stable exit codes: 0 ok, 1 a check failed, 2 usage, 3 a dependency is missing, 4 bad input or a failed step (capture-web.mjs adds 5 for an encoder failure). scripts/agent-take.sh uses only flags checked against Claude Code 2.1.306 and Codex 0.163.0 --help, and settings keys checked against the Claude Code binary's settings schema; recheck on newer versions.

House taste

• 4K and sharp. 3840x2160, each rendered frame a function of film time; 1080p is the social cut, not the master.
• Real footage, real clock. Every sped-up run shows a real-time timer; never reorder events, never splice two runs under one timer.
• Sections breathe. A caption stays up at least 1 s plus a third of a second per word. Land at 1x for about 1.5 s before and after a speed-up. Hold payoffs 3.5 s or more. Nothing shorter than about 1.2 s except a deliberate flash.
• Zooms are rare and shallow, about 1.1 to 1.3x, only to make something readable.
• Claims on screen are measured, or computed from the product's own data.
• Nothing private on screen: fictional demo data, persona accounts, no hostnames, tokens, or real customers.
• Open on a composed title card, because frame 0 is the preview.
• Fonts and color carry the brand; tag the stream bt709 so the colors survive players.

References

What This Skill is NOT

• Not a video editor tutorial. A trim, a format conversion, or a GIF of an existing clip needs plain ffmpeg and no shot list.
• Not permission to fake the product. Composed titles, music, and renders of real data are fine; staged product behavior is not.
• Not a substitute for the product's test suite. The reel finds what suites miss; the fixes still land with tests.
• Not a way around the user's authority. Publishing, merging fixes, or posting the reel follows the user's normal approvals; filming an agent never means loosening its permissions.