/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