feat(skills): add tooling-terminal-recording #1225

Merged
coilyco-ops merged 1 commit from aos/claude/tj49 into main 2026-08-24 01:17:59 +00:00
Owner

Adds tooling-terminal-recording, covering how to produce a terminal GIF or video without a live take.

What it carries

  • VHS for deterministic commands, where a wrong pause is an edit to a number rather than another take.
  • asciinema with -i 2 for anything whose timing cannot be predicted, which includes every agent session. The idle cap means the operator does not have to be quick or uninterrupted while recording.
  • Measure the widest line first, because that number dictates Set Width, Set FontSize, and whether the result is a usable aspect ratio at all.
  • Extract a frame before calling a render good. Wrapping, scrolled-off content, and mid-token cut damage are all invisible in the exit code.
  • macOS Preview steps an animated GIF frame by frame, so rendered output goes to a browser.

Provenance

Written from a session that hit each failure it warns about. A 196-character agent-compose catalog roles line produced either mid-word wrapping or an unusable 6.7:1 strip, and two renders were reported as fine on exit code alone before a frame was ever looked at.

No docs/FEATURES.md entry: one ordinary skill is not a major shipped capability, matching the existing tooling-ffmpeg and tooling-warp precedent.

pre-commit run --files clean, including skill conventions, documentation layout, and seed_skills_data.py in sync with skill frontmatter.

🤖 Generated with Claude Code

Adds `tooling-terminal-recording`, covering how to produce a terminal GIF or video without a live take. ## What it carries * **VHS** for deterministic commands, where a wrong pause is an edit to a number rather than another take. * **asciinema** with `-i 2` for anything whose timing cannot be predicted, which includes every agent session. The idle cap means the operator does not have to be quick or uninterrupted while recording. * **Measure the widest line first**, because that number dictates `Set Width`, `Set FontSize`, and whether the result is a usable aspect ratio at all. * **Extract a frame before calling a render good.** Wrapping, scrolled-off content, and mid-token `cut` damage are all invisible in the exit code. * macOS Preview steps an animated GIF frame by frame, so rendered output goes to a browser. ## Provenance Written from a session that hit each failure it warns about. A 196-character `agent-compose catalog roles` line produced either mid-word wrapping or an unusable 6.7:1 strip, and two renders were reported as fine on exit code alone before a frame was ever looked at. No `docs/FEATURES.md` entry: one ordinary skill is not a major shipped capability, matching the existing `tooling-ffmpeg` and `tooling-warp` precedent. `pre-commit run --files` clean, including `skill conventions`, `documentation layout`, and `seed_skills_data.py in sync with skill frontmatter`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(skills): add tooling-terminal-recording
All checks were successful
ci / aos-eval-tests (pull_request) Successful in 6s
ci / ward-doctor (pull_request) Successful in 7s
ci / aos-cli-tests (pull_request) Successful in 22s
ci / gate (pull_request) Successful in 54s
a746b6c771
Records terminal output as GIF or video without a live take. VHS for
deterministic commands, asciinema with an idle cap for sessions whose
timing cannot be predicted.

Written from a session that hit each failure it warns about: unmeasured
line width producing mid-word wrapping, a 196-character command yielding
an unusable 6.7:1 strip, and a render reported as good on exit code alone
without a frame ever being looked at.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
Agent-Role: devrel
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-flight-deck/agentic-os!1225
No description provided.