How do I install the Play skill?

Run npx skillmds add terrylica/play in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Play?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

terrylica (@terrylica) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Play by terrylica — Agent Skill

Name: Play
Rating: 4.2 (5 reviews)
Author: terrylica

File contents

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

---name: playdescription: Play .cast recordings in iTerm2 with speed controls. TRIGGERS - play recording, asciinema play, view cast.--- # /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 ```bash # 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.

Frequently asked questions

Play