/asciinema-tools:format

Display reference documentation for the asciinema v3 .cast format.

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 -f provided with parsing -> 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