Cc-skills play

Play .cast recordings in iTerm2 with speed controls. TRIGGERS - play recording, asciinema play, view cast.

install

source · Clone the upstream repo

git clone https://github.com/terrylica/cc-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/terrylica/cc-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/asciinema-tools/skills/play" ~/.claude/skills/terrylica-cc-skills-play && rm -rf "$T"

manifest: plugins/asciinema-tools/skills/play/SKILL.md

source content

/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

# 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.