← ClaudeAtlas

asciinemalisted

Record a scripted terminal demo of a CLI or TUI with asciinema: hidden fixture setup, commands typed on screen, TUI keys driven through tmux, a leak gate on the cast, scene-by-scene proof by replaying the cast, an agg GIF for the README, and upload to asciinema.org. Activates when the user says 'asciinema', 'record a terminal demo', 'screencast the CLI', 'record the TUI', 'add a demo GIF to the README', 'make a cast', or 'upload to asciinema'. Do not use for browser recordings (agent-browser) or produced motion video (video).
vanducng/skills · ★ 8 · AI & Automation · score 81
Install: claude install-skill vanducng/skills
# asciinema > Script the session, drive it, gate the cast, prove every scene from the cast, then publish. Never record a live shell. ## What this skill is - and isn't | Situation | Owner | |---|---| | README or PR demo of a CLI or TUI, `.cast` + GIF, asciinema.org upload | this skill | | Recording a browser flow | `agent-browser` | | Produced video, motion graphics, voiceover | `video` | | Proving a TUI change frame by frame (no recording) | the project's own screen harness | ## Hard rules 1. **Sample data only.** A public demo runs against a fixture server or sandbox account with generic content. The session script points the tool at an isolated config dir (`XDG_CONFIG_HOME` in a temp dir, fake auth) so it cannot read the real one. 2. **Never record an interactive shell.** A real prompt and rc files leak user, host, and paths. The session script prints a fake `$` prompt and types each command. 3. **The leak gate is not optional.** `record.sh` rewrites the header `command` (asciinema stores the full command line, absolute paths included) and fails on home paths, loopback addresses, token names, and every `--deny` string. A failure means fix the script, never edit around the gate. 4. **Prove scenes from the cast.** Run `cast-check.py --expect` with one marker per scene before calling a recording done. A missing marker means the choreography drifted. 5. **Upload is outward-facing.** Confirm with the user before `asciinema upload` or any visibility change. Uploads default t