Skill

play

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

Install

Run in your terminal

npx claudepluginhub terrylica/cc-skills --plugin asciinema-tools

Tool Access

This skill is limited to using the following tools:

BashAskUserQuestionGlob

Supporting Assets

View in Repository

references/evolution-log.md

Skill Content

Similar Skills

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

134.2k

executing-plans

Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.

superpowers

134.2k

brainstorming

7 files

Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.

superpowers

134.2k

Stats

Parent Repo Stars28

Parent Repo Forks4

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

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

# 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

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.

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