video-to-srt

Installation
SKILL.md

Video to SRT

Workflow

  1. Create a new top-level task folder for the request in the workspace.
  2. Locate the user's local media file and confirm the language choice only if it is unclear.
  3. Run scripts/run_local_subtitles.sh from this skill folder.
  4. Default to --language zh and --model small. Switch to --language auto for mixed language audio. Switch to --model medium only when the user wants better accuracy and accepts slower runtime.
  5. Inspect the generated .srt file by checking the first and last few cues before handing it off.
  6. Return the subtitle path and mention that editors which accept SRT, including Jianying desktop, can import it.

Stable Defaults

  • Keep dependency installation inside a local virtual environment created by scripts/run_local_subtitles.sh.
  • Keep caches local to the skill folder. This avoids macOS cache permission issues.
  • Keep HF_HUB_DISABLE_XET=1 enabled. This avoids a common Hugging Face Xet download failure.
  • Prefer SRT. It is the simplest subtitle format for broad editor compatibility.
  • Override VENV_DIR, HF_HOME, or XDG_CACHE_HOME only when reusing an existing environment or model cache is helpful.
Installs
1
First Seen
Apr 23, 2026