Destynova2/cli-code-skills / cli-forge-demo
cli-forge-demo
VerifiedGenerate a reproducible live-demo kit for any project: a staged demo script (DEMO.md), deterministic seed and idempotent reset wired into the project's own task runner (make / just / task / npm / ansible / flux / chainsaw — never an imposed .sh), a pre-flight checklist, and a backup recording. Picks the best delivery support for the project (live, terminal GIF via VHS, asciinema cast/SVG, subtitled video, or a self-guided 'next-next' interactive walkthrough) and lets you force one. Tunes dramaturgy to the audience: technique, fonctionnel, commercial, or pédagogique. Use when the user says 'demo', 'démo', 'live demo', 'demo script', 'demo gif', 'record a demo', 'show this off', 'walkthrough', 'interactive tutorial', 'present OpenBao', 'sprint review demo', 'sales demo', 'pitch demo', 'reproducible demo', 'reset demo data', 'seed demo', 'demo magic', 'asciinema', 'vhs tape', 'demo that does not break'. Do NOT use for slide decks (use cli-forge-prez) or for a README (use cli-forge-readme).
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 983 B |
| SKILL.md | skill md | 15.0 KB |
| references/anti-patterns.md | markdown | 3.4 KB |
| references/demo-md-template.md | markdown | 2.3 KB |
| references/dramaturgy.md | markdown | 3.7 KB |
| references/gif-video.md | markdown | 3.4 KB |
| references/interactive.md | markdown | 2.7 KB |
| references/staging.md | markdown | 4.4 KB |
| references/tiers.md | markdown | 3.7 KB |
| references/tooling.md | markdown | 4.1 KB |
references/gif-video.md
View on GitHub# GIF & Video — VHS Tapes, Sizing, Captions
> **When to read:** Step 4 when support = gif or video. Preferred tool for terminal demos: **VHS** (charmbracelet). For GUI/web: screencast + WebVTT.
## VHS tape — the recording as code
A `.tape` is a sequence of instructions VHS replays to render a GIF/MP4/WebM. Because it's code, it's reproducible, reviewable in a PR, and can gate CI against a golden render.
**Requires:** `vhs`, `ttyd`, `ffmpeg` on PATH.
### Annotated template (`demo.tape`)
```tape
# Output & quality
Output docs/demos/<name>/demo.gif
# Output docs/demos/<name>/demo.mp4 # uncomment for video
Set Theme "Catppuccin Mocha"
Set FontSize 22 # legible from the back of the room / on mobile
Set Width 1200
Set Height 640
Set Padding 24
Set TypingSpeed 60ms # human-paced, not instant
Set PlaybackSpeed 1.0
# --- Backstage setup: hide it (anti Yak-Shaving) ---
Hide
Type "make demo-reset && clear" Enter
Sleep 1s
Show
# --- Cold open: the showstopper first ---
Type "make demo" Enter
Sleep 3s # let viewers READ the payoff (anti Director's Cut)
# --- Beat 1 ---
Type "openbao kv get secret/app" Enter
Sleep 2s
# --- Beat 2 ---
Type "openbao kv rotate secret/app" Enter
Sleep 2s
Sleep 2s # hold final frame before loop
```
### Tape rules
- **`Hide`/`Show`** wrap all setup (reset, clear, auth). The viewer never sees backstage. (anti Yak-Shaving / Cold Open)
- **`Sleep` after each result** so the frame is readable. A GIF nobody can read is a Director's Cut.
- **FontSize ≥ 20**, width ≤ ~1200 for README/mobile legibility.
- **Total ≤ ~30–45 s**, one idea. If it's longer, it's a Feature Tour — split into multiple tapes.
- **Deterministic commands only** — same seed/clock, or the golden render drifts and CI flakes.
- **End on a held final frame** so the loop restart isn't jarring.
### Wire into the runner
```make
demo-gif:
vhs docs/demos/<name>/demo.tape
```
### CI / golden render (optional)
VHS in CI re-renders the tape on every change; diff the output (or a frame hash) against the committed asset to catch unintended UX changes — the demo doubles as a UX regression test.
## asciinema alternative (lighter, selectable text)
```
asciinema rec docs/demos/<name>/demo.cast # one clean run of `make demo`
agg docs/demos/<name>/demo.cast demo.gif # → GIF
svg-term --in demo.cast --out demo.svg --window # → SVG for README (tiny, text selectable)
```
Use when you want a featherweight, text-selectable README asset rather than a pixel GIF.
## Video + subtitles (GUI/web, accessibility)
VHS is terminal-only — for GUI/web demos use a screen recorder, then **always** ship captions:
- Emit a **WebVTT** `.vtt` track synced to the beats (reuse DEMO.md lines as caption text).
- Captions ≤ 2 lines, ~32 chars/line, on screen long enough to read.
- Never rely on color alone; ensure large, high-contrast text.
- Caption file lives beside the video: `docs/demos/<name>/demo.vtt`.
### Minimal WebVTT shape
```vtt
WEBVTT
00:00.000 --> 00:04.000
Here's the result: secrets rotated with one command.
00:04.000 --> 00:08.000
No restart, no downtime — the app picks up the new value live.
```
## Picking gif vs cast vs video — quick rule
Terminal demo → **VHS** (reproducible, CI-able). Need it featherweight + selectable in a README → **asciinema → svg-term**. GUI/web or spoken narration → **screencast + WebVTT**.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |