Play

/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

1. Preflight: Check iTerm2 and asciinema
2. Discovery: Find .cast files
3. Selection: AskUserQuestion for file
4. Speed: AskUserQuestion for playback speed
5. Options: AskUserQuestion for additional options
6. Launch: Open iTerm2 via AppleScript

Examples

# Play recording at normal speed
/asciinema-tools:play session.cast

# Play at 6x speed
/asciinema-tools:play session.cast -s 6

# Play with idle time limit and looping
/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:

1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. 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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: terrylica
• Source: terrylica/cc-skills
• License: MIT

Install and usage instructions live in the source repository linked above.