skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
terrylica/cc-skills91 installs

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 play
view source ↗

Is 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

ArgumentDescription
filePath to .cast file
-s, --speedPlayback speed (e.g., -s 6)
-i, --idle-time-limitMax idle time in seconds
-l, --loopLoop playback
-r, --resizeMatch terminal to recording size
-m, --markersPause 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

IssueCauseSolution
iTerm2 not foundNot installedbrew install --cask iterm2
Window not openingAppleScript issueGrant iTerm2 accessibility permissions
Playback stutteringLarge fileUse -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.

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>