srt

# /srt A skill that extracts the source-language subtitles of a video/audio via the Perso AI STT API — and then **you (the agent) translate them** into the requested languages. ## Core rules (must follow) - **Only the worker sees the raw key.** Never open the key with `Read`, echo it, or pass it as a command-line argument. Workers send it in the `XP-API-KEY` header only. - **One command = the whole extraction.** `scripts/srt.mjs` handles upload · transcription · SRT download by itself. - **Always run `srt.mjs` in the background.** Transcription takes minutes; a foreground shell timeout kills the run mid-way. - Language unspecified → target `en`. - **Transcription only, no translation** (user asks for "the subtitles/transcript as-is", "just the SRT in the original language") → run with `--transcribe-only` instead of `--target`. The downloaded original SRT **is** the final deliverable — skip the Translate section entirely. - **Multiple languages go in one command** (`--target en,ja`) — one subtitle project is created per input regardless of how many languages, and you translate its single original SRT into each of them. - **Relay progress faithfully.** Surface the worker's stdout `[progress]` lines to chat, verbatim or summarized. The indented stderr detail logs don't need relaying. For a batch the worker streams a `[progress]` line per input and prints a `[status]` heartbeat (`subtitles 3/20`, with a `next check ~Nm` hint) — check the background output ~3 minutes after laun...