record
Start terminal recording with asciinema. TRIGGERS - record session, capture terminal, start recording.
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill recordIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a wrapper for the terminal recording tool 'asciinema'. It includes instructions for the AI to self-correct its own documentation and execution logic. A security concern exists regarding potential command injection, as the skill constructs shell commands using user-supplied inputs (like file paths and recording titles) without explicit sanitization instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2 files scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
/asciinema-tools:record
Start a terminal recording session with asciinema.
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 | 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 --backup
Troubleshooting
| 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 |
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.
How can the creator link this skill?
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/record">View record on skillZs</a>