How do I install the Srt From Script skill?

Run npx skillmds@latest add gabrielmoreira/srt-from-script in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Srt From Script safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Srt From Script?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Srt From Script free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Srt From Script?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Srt From Script by gabrielmoreira — Agent Skill

Name: Srt From Script
Rating: 4.5 (4 reviews)
Author: gabrielmoreira

Srt From Script

Build an SRT subtitle file from a 3-shot short-drama script (ai-video-script OUTPUT FORMAT). Reads each SHOT_N block's DURATION_S + VOICEOVER, emits cumulative-timestamped SRT cues. Pure text-processing, no LLM, no network. Used by meta-short-drama between merge and the final subtitle-burn step.

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

srt-from-script

Parses an ai-video-script 3-shot script and writes an SRT subtitle file whose cues track the script's VOICEOVER per shot, time-coded with cumulative shot durations.

Inputs (`with:`)

key	required	default	notes
`script`	yes	—	Full script text (the entire OUTPUT FORMAT block, including OVERVIEW + SHOT_1..N). Passed via stdin so the orchestrator does not need to write a temp file.
`output_path`	yes	—	Output `.srt` path. Parent dir created if missing.
`gap_ms`	no	`200`	Tail pad subtracted from each cue's end so the subtitle vanishes ~200 ms before the next shot starts — avoids cuts clipping mid-character.
`leading_offset_ms`	no	`0`	Shifts every cue forward by this many ms. Set to the cover/intro clip duration when the merged video prepends a title card before SHOT_1.

Parsing rules

A shot with VOICEOVER: none or empty contributes no SRT cue but its DURATION_S still advances the timeline cursor.
Cue language follows the script verbatim. Chinese stays Chinese, English stays English — no translation.
Cumulative timestamps: SHOT_1 starts at 00:00:00,000; SHOT_2 starts at SHOT_1.duration; etc.
End time of each cue = next-shot start − gap_ms, clamped to ≥ 800 ms after start so very short voiceover lines remain readable.

Output

Prints the absolute path of the written .srt on stdout. The file is UTF-8 encoded so CJK voiceover lines survive when ffmpeg reads them via the subtitles= filter.

Limits

Assumes the script follows ai-video-script's strict OUTPUT FORMAT (=== SHOT_N === blocks with DURATION_S: and VOICEOVER: fields). Drift away from that format → zero cues, exit 1.
3-5 shots tested. Larger shot counts work but timestamps grow.

---name: srt-from-scriptdescription: Build an SRT subtitle file from a 3-shot short-drama script (ai-video-script OUTPUT FORMAT). Reads each SHOT_N block's DURATION_S + VOICEOVER, emits cumulative-timestamped SRT cues. Pure text-processing, no LLM, no network. Used by meta-short-drama between merge and the final subtitle-burn step.--- # srt-from-script Parses an ai-video-script 3-shot script and writes an SRT subtitle file whose cues track the script's VOICEOVER per shot, time-coded with cumulative shot durations. ## Inputs (`with:`) | key | required | default | notes | |---|---|---|---| | `script` | yes | — | Full script text (the entire OUTPUT FORMAT block, including OVERVIEW + SHOT_1..N). Passed via stdin so the orchestrator does not need to write a temp file. | | `output_path` | yes | — | Output `.srt` path. Parent dir created if missing. | | `gap_ms` | no | `200` | Tail pad subtracted from each cue's end so the subtitle vanishes ~200 ms before the next shot starts — avoids cuts clipping mid-character. | | `leading_offset_ms` | no | `0` | Shifts every cue forward by this many ms. Set to the cover/intro clip duration when the merged video prepends a title card before SHOT_1. | ## Parsing rules - A shot with `VOICEOVER: none` or empty contributes no SRT cue but its `DURATION_S` still advances the timeline cursor. - Cue language follows the script verbatim. Chinese stays Chinese, English stays English — no translation. - Cumulative timestamps: SHOT_1 starts at 00:00:00,000; SHOT_2 starts at SHOT_1.duration; etc. - End time of each cue = next-shot start − `gap_ms`, clamped to ≥ 800 ms after start so very short voiceover lines remain readable. ## Output Prints the absolute path of the written `.srt` on stdout. The file is UTF-8 encoded so CJK voiceover lines survive when ffmpeg reads them via the `subtitles=` filter. ## Limits - Assumes the script follows ai-video-script's strict OUTPUT FORMAT (`=== SHOT_N ===` blocks with `DURATION_S:` and `VOICEOVER:` fields). Drift away from that format → zero cues, exit 1. - 3-5 shots tested. Larger shot counts work but timestamps grow.

Frequently asked questions