cli-demo-generator
An agent skill by daymade, from daymade/claude-code-skills. Tags: cli, demo, documentation, generative, video.
What it does
Generates professional animated CLI demos as GIFs using VHS terminal recordings. Handles tape file creation, self-bootstrapping demos with hidden setup, output noise filtering, post-processing speed-up, and frame-level verification. Use when users want to create terminal demos, record CLI workflows as GIFs, generate animated documentation, build demo tapes for README files, or need to showcase any command-line tool visually. Also triggers on "record terminal", "VHS tape", "demo GIF", "animate my CLI", or any request to visually demonstrate shell commands.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add daymade/claude-code-skills --skill cli-demo-generator
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/cli-demo-generator ~/.claude/skills/cli-demo-generator
Safety box score
Grade D, elevated risk: 65 of 100 risk points, rated 2026-09-26. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill generates terminal demo GIFs by creating VHS tapes and, in its default path, runs those tapes through `vhs`, `asciinema`, and `gifsicle`. The main risks are arbitrary command execution from demo steps, hidden runtime-decoded shell code, and interactive recordings that can capture and persist secrets.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 3 (high) | The scripts execute generated demos and shell tools directly (`subprocess.run(['vhs', str(tape_file)], check=True)` and `subprocess.run(cmd, check=True)`), so user-supplied demo commands and bootstrap steps run in the user's shell environment. |
| Network access | 1 (low) | The repository itself does not fetch remote content, but its shipped examples include networked commands like `git clone https://github.com/user/repo.git` and `npm install`, so demos can easily touch the network. |
| Filesystem reach | 1 (low) | It writes output artifacts and side files such as `tape_file = output_path.with_suffix('.tape')`, `CAST_FILE="${OUTPUT%.gif}.cast"`, and temp files under `/tmp`, but stays mostly within the chosen output path. |
| Secrets & credentials | 2 (moderate) | `record_interactive.sh` runs `asciinema rec "$CAST_FILE"` after telling the user to “Type your commands naturally,” so passwords, tokens, or other typed secrets can be captured into the `.cast` and final demo. |
| Privilege & persistence | 2 (moderate) | The skill instructs users to install dependencies with commands like `brew install asciinema`, `brew install charmbracelet/tap/vhs`, and `sudo apt install asciinema`, which can require system-wide install privileges. |
| Instruction hijack surface | 3 (high) | The skill explicitly promotes hidden setup (`Hide`/`clear`/`Show`) and runtime-decoded code, and `scripts/auto_generate_demo.py` interpolates `filter_pattern` into shell code (`grep -v -E "{filter_pattern}"`), creating a shell-injection path. |
| Irreversible actions | 1 (low) | It can batch-generate multiple demos and automatically run them, but it does not itself publish, deploy, send messages, or perform irreversible external actions. |
| Transparency | 2 (moderate) | It uses runtime-decoded base64 shell snippets (`echo {encoded} | base64 -d > /tmp/cw.sh && source /tmp/cw.sh`) and `Hide`/`Show` patterns, so part of what runs is intentionally obscured until execution. |
Before installing
- Read `scripts/auto_generate_demo.py` for the unescaped `--filter` path before using untrusted regexes.
- Test `scripts/record_interactive.sh` in a scratch directory and confirm you are comfortable with the `.cast` file capturing the session.
- Decide whether you want the dependency installs (`brew install ...` / `sudo apt install ...`) to be system-wide before running it.
- If you plan to use hidden setup steps, inspect the generated `.tape` before running `vhs`.
Rated 2026-09-26 by an automated review of 8 files from the skill's repository.
Source
- Repository
- daymade/claude-code-skills (all skills from this repository)
- Path
- cli-demo-generator/SKILL.md
- Branch
- main
- Updated
- 2026-09-20
Related skills
- ad-creative — When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text.
- mermaid-to-proverif — Translates Mermaid sequenceDiagrams describing cryptographic protocols into ProVerif formal verification models (.pv files). Use when generating a ProVerif.
- remotion — Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays
- testing-handbook-generator — Generates Claude Code skills from the Trail of Bits Testing Handbook (appsec.guide).
- video — When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks.
- prompt-optimizer — Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology.