Skill

vhs-recording

Generates animated GIF recordings of terminal sessions from VHS tape files. Validates tapes, checks/installs VHS, executes recordings, verifies outputs. For demos and tutorials.

Bash

documentation

Install

npx claudepluginhub athola/claude-night-market --plugin scry

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Generate professional terminal recordings from VHS tape files.

Supporting Assets

modules/execution.mdmodules/tape-syntax.md

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.1k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

claude-code-plugin-release

1 file

Automates semantic versioning and release workflow for Claude Code plugins: bumps versions in package.json, marketplace.json, plugin.json; verifies builds; creates git tags, GitHub releases, changelogs.

claude-mem

64.7k

Stats

Parent Repo Stars242

Parent Repo Forks24

Last CommitMar 27, 2026

Actions

View Source View Plugin View on GitHub View README

VHS Recording Skill

Generate professional terminal recordings from VHS tape files.

When To Use

Recording terminal sessions with VHS tape scripts
Creating terminal demo recordings for documentation

When NOT To Use

Browser-based workflows - use scry:browser-recording instead
Non-terminal demos or GUI applications

Overview

VHS converts declarative tape files into animated GIFs of terminal sessions. Tape files define commands, timing, and terminal appearance.

Required TodoWrite Items

- Locate and validate tape file
- Check VHS installation status
- Execute VHS recording
- Verify output GIF creation

Module Reference

See modules/tape-syntax.md for VHS tape file directives
See modules/execution.md for recording workflow details

Workflow

Phase 1: Validate Tape File

Confirm tape file exists at specified path
Read tape file contents
Verify required directives:
- Output directive specifies GIF destination
- At least one action command (Type, Enter, etc.)

Phase 2: Check VHS Installation

which vhs && vhs --version

If not installed:

# Linux/WSL
go install github.com/charmbracelet/vhs@latest

# macOS
brew install charmbracelet/tap/vhs

# Also requires ttyd and ffmpeg

Phase 3: Execute Recording

vhs <tape-file.tape>

VHS will:

Parse tape file directives
Launch virtual terminal (ttyd)
Execute commands with timing
Capture frames
Encode to GIF using ffmpeg

Phase 4: Verify Output

Check GIF file exists at Output path
Verify file size is non-zero
Report success with output location

Exit Criteria

GIF file created at specified Output path
File size indicates successful recording (typically >50KB)
No error messages from VHS execution

Troubleshooting

Common Issues

If vhs is not found, verify that your Go bin directory is in your PATH (typically ~/go/bin). If the recording fails to start, ensure ttyd and ffmpeg are installed, as VHS depends on them for terminal emulation and video encoding. For "permission denied" errors when writing the GIF, check that the output directory exists and is writable.