play
Play .cast recordings in iTerm2 with speed controls. TRIGGERS - play recording, asciinema play, view cast.
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill playIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is functional but contains 'self-evolving' instructions that allow the agent to modify its own code. It also has an indirect prompt injection surface when processing external recording files.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2 files scanned · No issues
What does this agent skill do?
/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
fileprovided -> skip Phase 1 (file selection) - If
-sprovided -> skip Phase 2 (speed selection) - If any of
-i/-l/-r/-mprovided -> 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
# 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:
- 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/terrylica/cc-skills/play">View play on skillZs</a>