krillinai/OpenCreator / skills/krillinai-cli
krillinai-cli
VerifiedUse 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.
KrillinAI CLI
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-runfor 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.jsonand 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, orinternal. - Avoid rerunning expensive stages if the manifest already has valid upstream outputs.
- Do not claim that
coverconsumed a reference image: the current CLI accepts a complete text prompt and size only. - Do not request an Edge TTS voice catalog:
voicescurrently supportsaliyun,openai, andminimax.
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")
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |