mikeparcewski/wicked-garden / skills/demo
wicked-garden-demo
VerifiedProduct demo domain: plan, record and review a polished demo video. plan — frames the audience, builds the story, picks hero cases and fresh alternates, runs a live rehearsal with measured timings, and writes a presenter script with a chapter list ready for recording. record — records each chapter as its own captioned, chaptered segment via Playwright + ffmpeg (DevTools screencast encoded live to H.264, no frame files on disk, final CRF 17), then stitches them into one MP4 with chapters. review — generates labelled contact sheets of stills (at chapter slides, joins, and the end) and delivers a per-issue verdict: re-encode, re-record one segment, or fix the app. Use when: "plan a demo", "demo script", "presenter notes", "run of show", "rehearse a demo", "record a demo video", "walkthrough video", "feature tour", "re-record a segment", "stitch segments", "review the demo video", "QA the recording", "contact sheet", "demo workflow", "offline demo", "walkthrough storyline", "walkthrough lint", "walkthrough_plan".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 20.3 KB |
| assets/example-storyline.mjs | script | 7.8 KB |
| refs/gotchas.md | markdown | 8.4 KB |
| refs/rehearsal.md | markdown | 2.9 KB |
| refs/review-checklist.md | markdown | 6.1 KB |
| refs/stage-design.md | markdown | 6.2 KB |
| refs/storyline-api.md | markdown | 9.1 KB |
| refs/storyline-json.md | markdown | 6.1 KB |
| refs/storytelling.md | markdown | 3.3 KB |
| refs/templates.md | markdown | 4.5 KB |
| refs/walkthrough-author.md | markdown | 6.5 KB |
refs/storytelling.md
View on GitHub# Storytelling: chapters, captions, claims
## Chapter design
Each chapter answers one question the audience has, with one case, in a few minutes.
- **One capability per chapter.** If a chapter shows two things, split it or cut one.
- **Open with the problem**, in the customer's words where possible ("He typed the ESNs in by hand, please double
check them"). Then the action, then the result, then why it matters.
- **End on evidence.** A cited finding, a passed check, an audit entry: something the audience can verify on screen.
- **Self-contained.** Starts from a known page, uses its own cases, resets what it touches. Then chapters can be
reordered, dropped for a short path, or re-recorded alone.
- **Read-only when possible.** Tours of a library, a history, a dashboard or search need no reset and never fail.
## Ordering
Go from familiar to impressive to trustworthy:
1. **Triage**: the landing page as a ranked to-do list.
2. **Core flow end to end**: one clean case all the way to done, including the human approval steps.
3. **Hard cases**: messy input, missing information, conflicts, uploads that change the outcome.
4. **Learning and governance**: new knowledge captured once, reviewed by a second person, reused only where it applies.
5. **Knowledge and trust**: where the rules live, how checks are built from them, how a result links back to its rule.
6. **360 view**: everything about one customer, with an assistant that reads it.
7. **Wrap-up**: the audit trail and the measured numbers.
Put the most fragile live step early in a live session (energy is high, time is available) or pre-bake it.
Keep a **short path** (about a quarter of the length) that skips the deep dives.
## Chapter metadata (for slides and video)
For every chapter write:
- **Key**: `NN-slug` (`03-messy-input`), stable, used for files and re-recording.
- **Title**: 2-6 words, sentence case ("A hand-typed ESN list").
- **Blurb**: one sentence that states what the chapter proves, not what it clicks.
- **Tags**: 2-5 capability chips ("Extraction with sources", "Human gates", "Search").
- **Resets**: the cases it changes.
## Captions and voice
Captions (and presenter lines) follow the same pattern:
- **Kicker**: 1-3 words naming the beat ("Result", "Governance", "Upload").
- **Title**: one plain sentence, the takeaway ("Nothing needs attention: the unit actions reconcile").
- **Body**: optional, one or two lines of why or how; emphasise the key phrase.
Rules:
- Say what the audience should notice, in their words, not the UI's internals. No internal keys or code names.
- Present tense, active voice, short sentences. One idea per caption.
- The caption changes **with** the picture, not after it: introduce the next screen just before navigating to it.
- Give readers time: roughly 40 ms per character, 2.5 s minimum.
## Honest claims
- Numbers on screen or in the script are **measured** (say where) or labelled **estimate**. Never mix them.
- Name simulated systems and synthetic data out loud, once, early.
- Don't claim the model "knows" something the system checks deterministically; say which part is a rule in code and
which part is the model reading or explaining.
- Show the guardrail every time you show automation: who approved, what was refused, what was not applied and why.
- If a result varies between runs, say so in the script's recovery tips rather than hoping it won't.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |