# 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 short vertical subtitle output.

- Skill: `krillinai/krillinai-subtitle` (Agent Skill)
- Install (CLI): `npx skillmds@latest add krillinai/krillinai-subtitle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/krillinai/krillinai-subtitle/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: krillinai (https://skillmd.com/u/krillinai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/krillinai/krillinai-subtitle

---


# 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

```bash
(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`.