demo-with-narration

Installation
SKILL.md

Demo With Narration

STARTER_CHARACTER = 🎬

A demo is a proof performed twice: once fast and private to convince yourself, once slow and narrated to convince the person watching.

Stage 1: Self-demo

Exercise the real artifact the way its consumer will — the built binary, the running app. A green test suite is the starting point, not the proof.

  • Check every behavior you intend to claim: the happy path, each refusal path with its exact stderr reason and exit code, every way the session can end.
  • Probe at least one path beyond the obvious ones (quit from the menu, not just close the window) — the extra path is where green-suite bugs hide.
  • A detached GUI launch loses its exit status: wrap the launch in a subshell that writes $? to a file, read the file after the window closes.
  • Confirm a window really rendered with a screenshot; drive close and quit through accessibility clicks.

Done when every behavior you will claim in the walkthrough has been observed working, and any bug found is fixed and re-proven.

Stage 2: Narrated walkthrough

Installs
2
GitHub Stars
231
First Seen
Aug 14, 2026
demo-with-narration — lexler/skill-factory