Back to Krillinai

KrillinAI CLI

skills/krillinai-cli/SKILL.md

2.0.21.9 KB
Original Source

KrillinAI CLI

Use this as the top-level routing skill for KrillinAI command-line work.

Quick Start

Prefer the repo-local binary:

bash
./build/krillinai-cli <command> [flags]

If it does not exist, build it first:

bash
go build -o build/krillinai-cli ./cmd/cli

For common JSON, manifest, outputs, and error semantics, read:

text
skills/krillinai-cli/references/cli-contract.md

Choose The Command

User intentCommand / skill
Generate source, target, bilingual, and short vertical subtitlessubtitle; use krillinai-subtitle
Generate target-language dubbing from subtitlestts; use krillinai-tts
Create landscape videosrender-horizontal; use krillinai-render-horizontal
Create portrait/short-form videosrender-vertical; use krillinai-render-vertical

pipeline, cover, and status are planned/reserved surfaces in the current CLI. Use their skills for planning or dry-run documentation only unless the implementation has been wired in.

Operating Rules For Agents

  • Use a dedicated --workdir; do not scatter outputs in the repo root.
  • Prefer --dry-run when validating command shape or planning a run.
  • Parse stdout JSON and krillinai_manifest.json; do not parse normal logs.
  • Reuse manifest outputs for later stages instead of guessing filenames.
  • If a command fails, classify by error.kind: usage, retryable, dependency, or internal.
  • Avoid rerunning expensive stages if the manifest already has valid upstream outputs.

Minimal Workflow

bash
./build/krillinai-cli subtitle "https://www.youtube.com/watch?v=VIDEO_ID" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir tasks/demo \
  --caption-source any

./build/krillinai-cli render-vertical \
  --workdir tasks/demo \
  --video tasks/demo/origin_video.mp4 \
  --subtitle tasks/demo/short_origin_mixed_srt.srt