record

# /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 `file` provided -> skip Phase 1 (output location) - If `-t` and `-i` provided -> skip Phase 2 (options) ### Workflow 1. **Preflight**: Check asciinema installed 2. **Location**: AskUserQuestion for output path 3. **Options**: AskUserQuestion for recording options 4. **Generate**: Build and display recording command 5. **Guidance**: Show step-by-step instructions ## Examples ```bash # 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 ``` ## Troubleshoot...