krillinai-cli

Use when an agent needs to build or operate the embedded KrillinAI CLI, choose a supported command, or interpret its JSON, manifest, subtitle, dubbing, render, cover, speech, and voice outputs.

SKILL.md

Quality

Evals

Security

KrillinAI CLI

Name: krillinai-cli
Author: krillinai

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

Build And Locate The Binary

Build both KrillinAI binaries through the repository script:

pnpm krillinai:build

For the current machine, locate the CLI without assuming a platform or architecture:

TARGET="$(node -p "process.platform + '-' + process.arch")"
SUFFIX="$(node -p "process.platform === 'win32' ? '.exe' : ''")"
KRILLINAI_CLI="$PWD/.runtime/build/krillinai/$TARGET/bin/krillinai-cli$SUFFIX"
test -f "$KRILLINAI_CLI"

The CLI loads config/config.toml relative to its process working directory. For real runs from a source checkout, use runtime/krillinai as the process working directory and create its ignored config/config.toml from config/config-example.toml without overwriting an existing file. A release archive should be run from its unpacked package root.

For build layout, configuration, JSON, manifest, output, and error details, read:

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

Choose The Command

User intent	Command / skill
Generate source, target, bilingual, and short vertical subtitles	`subtitle`; use `krillinai-subtitle`
Generate target-language dubbing from subtitles	`tts`; use `krillinai-tts`
Create landscape videos	`render-horizontal`; use `krillinai-render-horizontal`
Create portrait/short-form videos	`render-vertical`; use `krillinai-render-vertical`
Generate a cover from a complete image prompt	`cover`; use `krillinai-cover`
Generate speech from plain text	`speech`
List provider voice codes for Aliyun, OpenAI, or MiniMax	`voices`
Validate a requested multi-stage output plan	`pipeline --dry-run`; use `krillinai-pipeline`

pipeline only validates plans in dry-run mode; non-dry-run execution returns unsupported_command. status is reserved and unsupported.

Operating Rules For Agents

Use a dedicated --workdir; do not scatter outputs in the repo root.
Use --dry-run for command-shape validation before external calls.
Parse stdout as JSON lines. The terminal response is the object containing ok; OpenCreator mode may emit progress frames first.
Treat krillinai_manifest.json and actual output files as the source of truth after a real stage.
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.
Do not claim that cover consumed a reference image: the current CLI accepts a complete text prompt and size only.
Do not request an Edge TTS voice catalog: voices currently supports aliyun, openai, and minimax.

Minimal Workflow

REPO_ROOT="$PWD"
WORKDIR="$REPO_ROOT/tasks/demo"
mkdir -p "$WORKDIR"

(cd "$REPO_ROOT/runtime/krillinai" && "$KRILLINAI_CLI" subtitle \
  "https://www.youtube.com/watch?v=VIDEO_ID" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir "$WORKDIR" \
  --caption-source any \
  --prepare-video)

(cd "$REPO_ROOT/runtime/krillinai" && "$KRILLINAI_CLI" render-vertical \
  --workdir "$WORKDIR")

Repository: krillinai/OpenCreator
Path: skills/krillinai-cli/SKILL.md
Commit: a153ac0

Last updated: 2 hours ago
First committed: 4 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.