krillinai-subtitle

Use when generating subtitles with KrillinAI CLI from a YouTube link, Bilibili/local video, or existing media, including platform caption download, Whisper fallback, translation, bilingual SRT, and sh

SKILL.md

GitHub

KrillinAI Subtitle

Use this skill for the subtitle stage. Read skills/krillinai-cli/references/cli-contract.md first for binary location, execution working directory, configuration, and JSON behavior.

Command

(cd "$KRILLINAI_CWD" && "$KRILLINAI_CLI" subtitle "<input>" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir "$WORKDIR" \
  --caption-source any \
  --prepare-video)

Inputs

  • YouTube URL: prefer --caption-source any; platform captions are used first, then Whisper fallback.
  • Local file: use local:/abs/path/video.mp4 or a path accepted by the CLI.
  • Bilibili or other yt-dlp supported links: use when media download works; platform caption behavior may differ, so expect transcription fallback.

Important Flags

Flag Use
--origin-lang Source language, such as en, zh, ja
--target-lang Target language, such as zh_cn
--workdir Dedicated task directory
--caption-source any Prefer platform captions, fallback to transcription
--caption-source whisper Force transcription
--prepare-video Require the original video for later render stages
--bilingual-top=true Put target language on top in bilingual SRT
--subtitle-style-file Merge a JSON subtitle-style override
--dry-run Validate without downloads or AI calls

Outputs

After a real run, read paths from krillinai_manifest.json. Main files:

  • origin_language_srt.srt
  • target_language_srt.srt
  • bilingual_srt.srt
  • short_origin_mixed_srt.srt
  • origin_video.mp4 when media preparation produced or required video
  • origin_audio.mp3 when transcription preparation produced audio

subtitle --dry-run validates command shape but does not write a manifest or output files.

Verification

  • Require terminal JSON with "ok": true.
  • Confirm krillinai_manifest.json exists under --workdir.
  • Spot-check bilingual_srt.srt ordering and short_origin_mixed_srt.srt readability.
  • When --prepare-video was requested, require a non-empty origin_video output.
  • For Agent integration details, read skills/krillinai-cli/references/cli-contract.md.