| name | play |
| description | Play .cast recordings in iTerm2 with speed controls. TRIGGERS - play recording, asciinema play, view cast. |
| allowed-tools | Bash, AskUserQuestion, Glob |
| argument-hint | [file] [-s speed] [-i idle-limit] [-l loop] [-r resize] [-m markers] |
| model | haiku |
/asciinema-tools:play
Play terminal recordings in a dedicated iTerm2 window.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Arguments
| Argument | Description |
|---|
file | Path to .cast file |
-s, --speed | Playback speed (e.g., -s 6) |
-i, --idle-time-limit | Max idle time in seconds |
-l, --loop | Loop playback |
-r, --resize | Match terminal to recording size |
-m, --markers | Pause on markers |
Execution
Invoke the asciinema-player skill with user-selected options.
Skip Logic
- If
file provided -> skip Phase 1 (file selection)
- If
-s provided -> skip Phase 2 (speed selection)
- If any of
-i/-l/-r/-m provided -> skip Phase 3 (options)
Workflow
- Preflight: Check iTerm2 and asciinema
- Discovery: Find .cast files
- Selection: AskUserQuestion for file
- Speed: AskUserQuestion for playback speed
- Options: AskUserQuestion for additional options
- Launch: Open iTerm2 via AppleScript
Examples
/asciinema-tools:play session.cast
/asciinema-tools:play session.cast -s 6
/asciinema-tools:play session.cast -i 2 -l
Troubleshooting
| Issue | Cause | Solution |
|---|
| iTerm2 not found | Not installed | brew install --cask iterm2 |
| Window not opening | AppleScript issue | Grant iTerm2 accessibility permissions |
| Playback stuttering | Large file | Use -i 1 to cap idle time |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.
