Vhs

A comprehensive rulebook for creating terminal recordings with Charmbracelet's VHS tool. You get 47 specific rules across 8 categories, from critical stuff like config ordering and dependency validation to timing tricks and CI automation patterns. Each rule links to detailed examples for writing .tape files that generate professional terminal GIFs and videos. The priority system is smart: it pushes you toward the configuration and dependency issues that'll bite you first, then layers on the polish. If you're documenting CLIs or building automated demo pipelines, this gives you the conventions and gotchas that keep tape files maintainable and outputs consistent across environments.

skills.sh installs: 331
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill vhs --agent claude-code

Installs into .claude/skills of the current project.

Files

Charmbracelet VHS Best Practices

Comprehensive best practices guide for VHS terminal recordings, maintained by Charmbracelet. Contains 47 rules across 8 categories, prioritized by impact to guide creation of professional, portable, and optimized terminal demos.

When to Apply

Reference these guidelines when:

Writing new VHS tape files
Creating terminal demos for documentation
Setting up CI/CD for automated GIF generation
Optimizing recording file size and quality
Troubleshooting tape file issues
Reviewing tape files for best practices

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Configuration Structure	CRITICAL	`config-`
2	Dependency Management	CRITICAL	`deps-`
3	Command Syntax	HIGH	`cmd-`
4	Timing & Synchronization	HIGH	`timing-`
5	Output Optimization	MEDIUM-HIGH	`output-`
6	Visual Quality	MEDIUM	`visual-`
7	CI/Automation	MEDIUM	`ci-`
8	Advanced Patterns	LOW	`advanced-`