1. Habit
  2. Skills
  3. VHS Demo skill
cli · 38 installs

VHS Demo skill
Runs by itself, CLI output changes.

Before and after GIFs reviewers trust.

Install the VHS Demo skill and make it a habit: follow https://gethabit.dev/skills/cli/vhs-demo.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

38 installs47K starsMIT licenceSource on GitHub ↗

VHS Demo

by cli · 38 installs

The skill

The vhs demo skill helps CLI developers record short, repeatable terminal GIFs with VHS as before/after evidence for reviewers, with isolated config and frame-by-frame inspection.

Only when you ask.

The habit

Before and after GIFs reviewers trust.

↻ Runs by itselfCLI output changes

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

CLI output changes. Runs in Claude Code routine.

  • ↻ CLI output changes
  • pull_request labelled for demo evidence

02

It checks its work

preflight and inspection pass. If a check fails, it stops.

  • ✓preflight.sh passes with VHS 0.11.0 or newer
  • ✓vhs <tape> renders without parse errors
  • ✓inspect.sh verifies GIF metadata outside the repository
  • ✓each executable's path, version and hash is recorded

03

It remembers

demo evidence log. The next run reads it first: tape settings and geometry used for earlier demos.

loops/vhs-demo-evidence-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after one before/after pair per run.

  1. 01

    Define the claim

    Write down the behavior, visible commands, initial state and the controlled variable.

  2. 02

    Run preflight

    Run .github/skills/vhs-demo/scripts/preflight.sh and stop if a tool is missing.

  3. 03

    Prove executables

    Record absolute path, version, revision and SHA-256 for each binary.

  4. 04

    Isolate the take

    Use a temp workspace, synthetic data and cleared credential variables.

  5. 05

    Render

    Author the tape with Wait+Screen for results and run vhs.

  6. 06

    Inspect

    Run inspect.sh and check every frame for secrets, clipping and transient states.

  7. 07

    Return evidence

    Report tape and GIF paths, size, duration and what the demo does not prove.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the VHS Demo skill helps.

Use it when

  • ✓ You need a terminal GIF for a PR
  • ✓ You show before and after CLI output
  • ✓ You author a VHS tape

Skip it when

  • – VHS, ffmpeg or ttyd cannot run
  • – You need proof of general correctness

Questions

VHS Demo skill, answered.

Can it use another recorder?

No. If VHS is missing the skill stops and reports the failed prerequisite.

Does the GIF go into the repo?

No. All generated media stays in a temporary workspace.

How do I install the VHS Demo skill?

Copy the prompt at the top into your agent. It installs the skill from cli/cli and sets up the habit. Or run npx skills add cli/cli --skill vhs-demo.

Is the VHS Demo skill free?

Yes. It is published under MIT. Habit is free too.

VHS Demo. Now as a habit.

Install the VHS Demo skill and make it a habit: follow https://gethabit.dev/skills/cli/vhs-demo.md

  • Free
  • No account
  • Undo in one line

All cli skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by cli, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.