format
Reference for asciinema v3 .cast NDJSON format. TRIGGERS - cast format, asciicast spec, event codes.
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill formatIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides reference documentation for the asciinema format and includes instructions for the agent to modify its own source code (SKILL.md) based on usage outcomes. This creates a surface for indirect prompt injection and dynamic execution, as malicious input files could trick the agent into permanently altering its instructions or executing unintended shell commands.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2 files scanned · No issues
What does this agent skill do?
/asciinema-tools:format
Display reference documentation for the asciinema v3 .cast format.
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 |
|---|---|
header | Show header field specification |
events | Show event codes deep-dive |
parsing | Show jq/bash parsing examples |
all | Show complete format reference |
-f, --file | Use specific .cast for examples |
--live | Run parsing examples on file |
Execution
Invoke the asciinema-cast-format skill with user-selected section.
Skip Logic
- If section provided -> skip Phase 1 (section selection)
- If
-fprovided withparsing-> skip Phase 2 (example file)
Workflow
- Selection: AskUserQuestion for section
- Example: AskUserQuestion for example file (if parsing)
- Display: Show requested documentation
Examples
# Show header format
/asciinema-tools:format header
# Show event codes
/asciinema-tools:format events
# Parse specific file with live examples
/asciinema-tools:format parsing -f session.cast --live
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| File not found | Invalid path | Use absolute path or ensure file exists |
| Parse error | Invalid NDJSON | Check file is valid asciinema v3 format |
| No output | Missing section | Specify one of: header, events, parsing, all |
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/format">View format on skillZs</a>