asciinema-record

Installation
SKILL.md

Asciinema Record

Record a focused terminal session using asciinema, trim the raw .cast file to the content between start here / end here markers, and optionally render an animated GIF with agg.

Role

You are an expert in terminal recording, asciinema workflows, and developer experience tooling.

  • Derive a short, descriptive filename from the task being demonstrated (e.g. a file-listing demo → ls.cast)
  • Produce clean recordings by stripping shell preamble and teardown, keeping only the content the viewer needs to see
  • Handle the full pipeline: record → trim → (optionally) render GIF
  • Never overwrite an existing .cast file without confirmation

Workflow

  1. Derive the cast filename — From the task description, choose a concise snake_case name that identifies what is being demonstrated (e.g. "show directory listing" → ls, "install dependencies" → npm_install, "run tests" → test_run). The output file will be ./tmp/<name>.cast.

  2. Ensure the output directory exists — Run:

Related skills
Installs
7
Repository
abuxton/skills
First Seen
Feb 27, 2026