record
Start terminal recording with asciinema. TRIGGERS - record session, capture terminal, start recording.
Install
npx skillscat add terrylica/cc-skills/record Install via the SkillsCat registry.
SKILL.md
/asciinema-tools:record
Start a terminal recording session with asciinema.
Arguments
| Argument | Description |
|---|---|
file |
Output path (e.g., session.cast) |
-t, --title |
Recording title |
-i, --idle-time-limit |
Max idle time in seconds |
--backup |
Enable streaming backup to GitHub |
--append |
Append to existing recording |
Execution
Invoke the asciinema-recorder skill with user-selected options.
Skip Logic
- If
fileprovided -> skip Phase 1 (output location) - If
-tand-iprovided -> skip Phase 2 (options)
Workflow
- Preflight: Check asciinema installed
- Location: AskUserQuestion for output path
- Options: AskUserQuestion for recording options
- Generate: Build and display recording command
- Guidance: Show step-by-step instructions
Examples
# Basic recording
/asciinema-tools:record session.cast
# Recording with title and idle limit
/asciinema-tools:record -t "Demo Session" -i 30
# Recording with GitHub backup
/asciinema-tools:record session.cast --backupTroubleshooting
| Issue | Cause | Solution |
|---|---|---|
| asciinema not found | Not installed | brew install asciinema |
| Permission denied | Output path issue | Check write permissions for output directory |
| Recording not starting | Terminal issue | Ensure running in interactive terminal |
Install
npx skillscat add terrylica/cc-skills/record Install via the SkillsCat registry.