Skip to main content Home Creators seaworld008 commonly-used-high-value-skills cli-demo-generator
cli-demo-generator This skill should be used when users want to create animated CLI demos, terminal recordings, or command-line demonstration GIFs. It supports both manual tape file creation and automated demo generation from command descriptions. Use when users mention creating demos, recording terminal sessions, or generating animated GIFs of CLI workflows.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/seaworld008/Commonly-used-high-value-skills --skill cli-demo-generatorThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository Multi-agent collaboration plugin that spawns N parallel subagents competing on the same task via git worktree isolation. Agents work independently, results are evaluated by metric or LLM judge, and the best branch is merged. Use when: user wants multiple approaches tried in parallel — code optimization, content variation, research exploration, or any task that benefits from parallel competition. Requires: a git repo.
Design production-grade multi-agent orchestration systems. Covers five core patterns (sequential pipeline, parallel fan-out/fan-in, hierarchical delegation, event-driven, consensus), platform-specific implementations, handoff protocols, state management, error recovery, context window budgeting, and cost optimization.
App Store Optimization toolkit for researching keywords, optimizing metadata, and tracking mobile app performance on Apple App Store and Google Play Store.
Related occupations SOC
Based on SOC occupation classification
name cli-demo-generator description This skill should be used when users want to create animated CLI demos, terminal recordings, or command-line demonstration GIFs. It supports both manual tape file creation and automated demo generation from command descriptions. Use when users mention creating demos, recording terminal sessions, or generating animated GIFs of CLI workflows. zh_description 用于CLI、演示、生成，支持开发、调试、评审和交付。 version 1.0.0 author seaworld008 source in-house source_url tags ["cli", "demo", "development", "generator"] created_at 2026-03-04 updated_at 2026-03-20 quality 5 complexity intermediate
CLI Demo Generator
Generate professional animated CLI demos with ease. This skill supports both automated generation from command descriptions and manual control for custom demos.
When to Use This Skill
Trigger this skill when users request:
"Create a demo showing how to install my package"
"Generate a CLI demo of these commands"
"Make an animated GIF of my terminal workflow"
"Record a terminal session and convert to GIF"
"Batch generate demos from this config"
"Create an interactive typing demo"
Core Capabilities
1. Automated Demo Generation (Recommended)
Use the auto_generate_demo.py script for quick, automated demo creation. This is the easiest and most common approach.
Basic Usage:
scripts/auto_generate_demo.py \
-c "npm install my-package" \
-c "npm run build" \
-o demo.gif
With Options:
scripts/auto_generate_demo.py \
-c "command1" \
-c "command2" \
-o output.gif \
--title "Installation Demo" \
--theme "Dracula" \
--width 1400 \
--height 700
Script Parameters:
-c, --command: Command to include (can be specified multiple times)-o, --output: Output GIF file path (required)--title: Demo title (optional, shown at start)--theme: VHS theme (default: Dracula)--font-size: Font size (default: 16)--width: Terminal width (default: 1400)--height: Terminal height (default: 700)--no-execute: Generate tape file only, don't execute VHS
Smart Features:
Automatic timing based on command complexity
Optimized sleep durations (1-3s depending on operation)
Proper spacing between commands
Professional defaults
2. Batch Demo Generation
Use batch_generate.py for creating multiple demos from a configuration file.
Configuration File (YAML):
demos:
- name: "Install Demo"
output: "install.gif"
title: "Installation"
theme: "Dracula"
commands:
- "npm install my-package"
- "npm run build"
- name: "Usage Demo"
output: "usage.gif"
commands:
- "my-package --help"
- "my-package run"
scripts/batch_generate.py config.yaml --output-dir ./demos
When to Use Batch Generation:
Creating a suite of related demos
Documenting multiple features
Generating demos for tutorials or documentation
Maintaining consistent demo series
3. Interactive Recording Use record_interactive.sh for recording live terminal sessions.
scripts/record_interactive.sh output.gif \
--theme "Dracula" \
--width 1400
Script starts asciinema recording
Type commands naturally in your terminal
Press Ctrl+D when finished
Script auto-converts to GIF via VHS
When to Use Interactive Recording:
Demonstrating complex workflows
Showing real command output
Capturing live interactions
Recording debugging sessions
4. Manual Tape File Creation For maximum control, create VHS tape files manually using templates.
assets/templates/basic.tape - Simple command demoassets/templates/interactive.tape - Typing simulation
Copy template: cp assets/templates/basic.tape my-demo.tape
Edit commands and timing
Generate GIF: vhs < my-demo.tape
Consult references/vhs_syntax.md for complete VHS syntax reference.
Workflow Guidance
For Simple Demos (1-3 commands) Use automated generation for quick results:
scripts/auto_generate_demo.py \
-c "echo 'Hello World'" \
-c "ls -la" \
-o hello-demo.gif \
--title "Hello Demo"
For Multiple Related Demos Create a batch configuration file and use batch generation:
Create demos-config.yaml with all demo definitions
Run: scripts/batch_generate.py demos-config.yaml --output-dir ./output
All demos generate automatically with consistent settings
For Interactive/Complex Workflows Use interactive recording to capture real behavior:
scripts/record_interactive.sh my-workflow.gif
For Custom Timing/Layout Create manual tape file with precise control:
Start with template or generate base tape with --no-execute
Edit timing, add comments, customize layout
Generate: vhs < custom-demo.tape
Best Practices Refer to references/best_practices.md for comprehensive guidelines. Key recommendations:
Quick commands (ls, pwd): 1s sleep
Standard commands (grep, cat): 2s sleep
Heavy operations (install, build): 3s+ sleep
Standard: 1400x700 (recommended)
Compact: 1200x600
Presentations: 1800x900
Documentation: Nord, GitHub Dark
Code demos: Dracula, Monokai
Presentations: High-contrast themes
Target: 15-30 seconds
Maximum: 60 seconds
Create series for complex topics
Troubleshooting
VHS Not Installed
brew install vhs
go install github.com/charmbracelet/vhs@latest
Asciinema Not Installed
brew install asciinema
sudo apt install asciinema
Demo File Too Large
Reduce duration (shorter sleep times)
Use smaller dimensions (1200x600)
Consider MP4 format: Output demo.mp4
Split into multiple shorter demos
Output Not Readable
Increase font size: --font-size 18
Use wider terminal: --width 1600
Choose high-contrast theme: --theme "Dracula"
Test on target display device
Examples
Example 1: Quick Install Demo User request: "Create a demo showing npm install"
scripts/auto_generate_demo.py \
-c "npm install my-package" \
-o install-demo.gif \
--title "Package Installation"
Example 2: Multi-Step Tutorial User request: "Create a demo showing project setup with git clone, install, and run"
scripts/auto_generate_demo.py \
-c "git clone https://github.com/user/repo.git" \
-c "cd repo" \
-c "npm install" \
-c "npm start" \
-o setup-demo.gif \
--title "Project Setup" \
--theme "Nord"
Example 3: Batch Generation User request: "Generate demos for all my CLI tool features"
Create features-demos.yaml:
demos:
- name: "Help Command"
output: "help.gif"
commands: ["my-tool --help" ]
- name: "Init Command"
output: "init.gif"
commands: ["my-tool init" , "ls -la" ]
- name: "Run Command"
output: "run.gif"
commands: ["my-tool run --verbose" ]
scripts/batch_generate.py features-demos.yaml --output-dir ./demos
Example 4: Interactive Session User request: "Record me using my CLI tool interactively"
scripts/record_interactive.sh my-session.gif --theme "Tokyo Night"
Bundled Resources
scripts/
auto_generate_demo.pybatch_generate.pyrecord_interactive.sh
references/
vhs_syntax.mdbest_practices.md
assets/
templates/basic.tapetemplates/interactive.tapeexamples/batch-config.yaml
Dependencies
asciinema (for interactive recording)
PyYAML (for batch YAML configs): pip install pyyaml
Output Formats VHS supports multiple output formats:
Output demo.gif # GIF (default, best for documentation)
Output demo.mp4 # MP4 (better compression for long demos)
Output demo.webm # WebM (smaller file size)
Choose based on use case:
GIF : Documentation, README files, easy embeddingMP4 : Longer demos, better quality, smaller sizeWebM : Web-optimized, smallest file size
Summary This skill provides three main approaches:
Automated (auto_generate_demo.py) - Quick, easy, smart defaultsBatch (batch_generate.py) - Multiple demos, consistent settingsInteractive (record_interactive.sh) - Live recording, real output Choose the approach that best fits the user's needs. For most cases, automated generation is the fastest and most convenient option.
