NarratorAI-Studio/narrator-ai-cli-skill
narrator-ai-cli
VerifiedAI 电影/短剧解说视频自动生成(AI 解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现:搜片→选模板→选 BGM→选配音→生成文案→合成视频的全流程自动化。CLI client for Narrator AI video narration API.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.9 KB |
| references/magic-video.md | markdown | 10.9 KB |
| references/operations.md | markdown | 11.2 KB |
| references/resources.md | markdown | 6.0 KB |
| references/workflows.md | markdown | 16.5 KB |
references/magic-video.md
View on GitHub# Magic Video — Visual Templates (Optional Step)
> ← Back to [SKILL.md](../SKILL.md)
> ⚠️ **Agent restriction**: Do NOT auto-create magic-video tasks. Only create when the user **explicitly requests** a visual template. Present the catalog, explain options, let the user choose. Multiple templates can be selected — each produces a separate output video.
Magic Video is a value-added service applied **after** video-composing:
- Adds professional subtitle styles and branded layouts to the finished video
- Multiple templates may be selected simultaneously (one output video per template)
- **Pricing: 30 points/minute** (based on output video duration)
**Input**: the `task_id` returned from `video-composing`.
---
## Template Catalog
List templates with name + price + description via the CLI:
```bash
narrator-ai-cli task templates --json
```
> ⚠️ The CLI list does **not** include per-template `params` schemas (e.g. `main_title`, `segment_count`, `bottom_disclaimer_text`). Use the static catalog below for params, or hit the raw endpoint when you need authoritative real-time param defaults:
>
> ```bash
> curl -X GET "https://openapi.jieshuo.cn/v2/task/commentary/get_magic_template_info" \
> -H "app-key: $NARRATOR_APP_KEY"
> ```
Templates are organized by distribution platform and aspect ratio.
### 油管 (YouTube)
| Aspect Ratio | Template Name | Configurable Params |
|---|---|---|
| 9:16 垂直 | 竖屏·合规剧集 | `main_title`, `bottom_disclaimer_text`, `vertical_text_content`, `segment_count` |
| 9:16 垂直 | 竖屏·柔光剧集 | `segment_count` |
| 9:16 垂直 | 竖屏·模糊剧集 | `main_title`, `segment_count` |
| 9:16 垂直 | 竖屏·简约剧集 | `segment_count` |
| 9:16 垂直 | 竖屏·黑金剧集 | `main_title`, `sub_title`, `segment_count` |
| 16:9 水平 | 横屏·沉浸剧集 | `segment_count` |
| 16:9 水平 | 横屏·电影剧集 | `main_title`, `sub_title`, `segment_count` |
| 16:9 水平 | 横屏·简约剧集 | `segment_count` |
### 抖音 (TikTok / Douyin)
| Aspect Ratio | Template Name | Configurable Params |
|---|---|---|
| 1:1 矩形 | 方屏·简约剧集 | `main_title`, `watermark_text`, `segment_count` |
| 1:1 矩形 | 方屏·雅致剧集 | `main_title`, `segment_count` |
| 9:16 垂直 | 竖屏·流光剧集 | `slogan`, `vertical_text_content`, `segment_count` |
### 油管短视频 (YouTube Shorts)
| Aspect Ratio | Template Name | Configurable Params |
|---|---|---|
| 9:16 垂直 | 竖屏·精准剧集 | `segment_count` |
| 9:16 垂直 | 竖屏·重磅剧集 | `sub_title` ⚠️, `segment_count` |
---
## Language Awareness (Critical)
> All text params (`main_title`, `sub_title`, `bottom_disclaimer_text`, `vertical_text_content`, `watermark_text`, `slogan`) have **Chinese default values hardcoded in the template** and do NOT auto-adapt to the target language.
When the narration target language is **not Chinese**, the agent MUST:
1. **Never submit Chinese default values.** Submitting Chinese defaults will produce Chinese text in a non-Chinese video — always wrong.
2. **Proactively provide localized values for every text param.** Do not ask the user whether they want localization — assume yes and act on it.
3. **Translate the standard defaults to the target language and confirm with the user before submitting.** Required translations:
- `bottom_disclaimer_text` default `本故事纯属虚构 请勿模仿` → e.g. English: `This story is purely fictional. Do not imitate.`
- `vertical_text_content` default `影视效果 请勿模仿 合理安排生活` → e.g. English: `Cinematic effects only. Do not imitate. Manage your life wisely.`
- `main_title`, `sub_title`, `watermark_text`, `slogan` — if left empty, AI may still generate Chinese; proactively ask for user input or suggest a translated value.
4. **This rule applies even when the user does not mention language.** The pipeline language is a single chain (dubbing → writing `language` → magic-video text params) — see SKILL.md § Agent Rules ("Honor the language chain"). Never treat the three steps as independent.
5. **Ask all user-facing questions in the same language as the ongoing conversation.** Do not default to Chinese if the conversation is in another language.
6. **Scope**: this rule governs magic-video template text params only. The narration-script `language` param is handled at the writing step (`fast-writing` / `generate-writing`).
---
## Param Reference
> ⚠️ **Agent behavior**: When the user picks a template, walk through each of its configurable params, explain what it controls, and ask for a value. Only submit once every param is confirmed or explicitly left at default.
All params are optional — omitting them lets AI auto-generate where supported.
### `segment_count` — 分集设置 (`int`, in all templates)
Controls how the video is split into episodes:
| Value | Behavior | When to use |
|---|---|---|
| `0` (default) | AI auto-determines episode count based on content length | Recommended for most cases |
| `-1` | No splitting — output as a single video | Source is short, or user wants one file |
| `1`, `2`, `3`… | Force exactly N episodes | User has a specific series structure in mind |
> Ask: "要分集吗?留 `0` 让 AI 自动判断,指定集数,还是 `-1` 不分集?"
### `main_title` — 主标题 (`string`)
Templates: 竖屏·合规剧集, 竖屏·模糊剧集, 竖屏·黑金剧集, 横屏·电影剧集, 方屏·简约剧集, 方屏·雅致剧集.
Primary title displayed prominently on screen.
- **Leave empty (recommended)**: AI generates the most fitting title from content
- **Fill in**: when the user wants a custom series name, channel brand, or overrides the AI-generated title
- **Format tip**: keep under 10–12 chars for vertical layouts; under 16 for horizontal. Avoid layout-breaking punctuation
- ⚠️ **Non-Chinese narration**: leaving empty may cause AI to generate a Chinese title. See Language Awareness above
> Ask whether the user wants a custom title or prefers AI-generated. (In the conversation language.)
### `sub_title` — 副标题 (`string`)
Templates: 竖屏·黑金剧集, 横屏·电影剧集, 竖屏·重磅剧集.
Secondary text displayed near the main title.
- **Leave empty (recommended)**: AI auto-generates a short tagline
- **Fill in**: when user wants a specific promotional slogan or episode label
- ⚠️ **Special behavior in 竖屏·重磅剧集**: filling `sub_title` will **completely override the main title display** — the value entered replaces whatever would appear as main title. Only fill if the user specifically wants to override
- ⚠️ **Non-Chinese narration**: leaving empty may cause AI to generate a Chinese tagline
> Ask whether the user wants a custom subtitle. For 竖屏·重磅剧集, warn that filling will override main title.
### `bottom_disclaimer_text` — 底部免责文案 (`string`)
Template: 竖屏·合规剧集 only.
Disclaimer pinned to the bottom of the screen — required for compliance on many platforms.
- **Chinese narration — keep default**: `本故事纯属虚构 请勿模仿` covers standard platform compliance
- **Non-Chinese narration — MUST translate**: default is Chinese and would display as Chinese in a non-Chinese video. Translate to target language (e.g. English: `This story is purely fictional. Do not imitate.`) and confirm before submitting. **Do NOT submit the Chinese default for non-Chinese narration.**
- **Customize**: when user has a specific legal disclaimer or platform requires different wording
- **Do not leave blank**: empty value removes the disclaimer, which may cause compliance issues
> Chinese narration: "底部免责文案保留默认「本故事纯属虚构 请勿模仿」就好,有特殊合规需求才需要改。"
> Non-Chinese narration: translate default → show translated value → ask for confirmation/edits.
### `vertical_text_content` — 侧边警示语 / 侧边文案 (`string`)
Templates: 竖屏·合规剧集, 竖屏·流光剧集.
Vertical text displayed along the side edge.
- **Chinese narration — keep default**: `影视效果 请勿模仿 合理安排生活` is standard compliance phrasing
- **Non-Chinese narration — MUST translate**: default is Chinese (e.g. English: `Cinematic effects only. Do not imitate. Manage your life wisely.`). Confirm before submitting. **Do NOT submit the Chinese default for non-Chinese narration.**
- **Customize**: channel-specific watermark phrase or branded vertical tagline
- **Format tip**: keep concise — text renders vertically, shorter phrases look cleaner
> Same prompts as `bottom_disclaimer_text` above.
### `watermark_text` — 水印文案 (`string`)
Template: 方屏·简约剧集 only.
Copyright/brand text that roams randomly across the frame as a floating watermark.
- **Leave empty**: no watermark displayed
- **Fill in**: copyright protection or channel branding (e.g. `@ChannelName`, `© Studio Name`)
- **Format tip**: short phrases work best (under 15 chars) — long text looks cluttered as it moves
- ⚠️ **Non-Chinese narration**: value must be in the target language
> Ask if the user wants a watermark. If yes, ask for the text.
### `slogan` — 顶部标语 (`string`)
Template: 竖屏·流光剧集 only.
Custom text that fills the entire top title bar, overriding whatever the AI would generate.
- **Leave empty (recommended)**: AI auto-generates a contextually appropriate top title
- **Fill in**: only when the user has a fixed brand slogan or exclusive tagline. Once filled, AI title generation for this slot is bypassed
- ⚠️ **Non-Chinese narration**: leaving empty may cause AI to generate a Chinese slogan
> Ask if the user wants a fixed top slogan.
---
## Creating a Magic Video
> ⚠️ **Agent behavior — mandatory pre-submission confirmation**: Before running any `magic-video` create command, the agent MUST display the full request parameters to the user in a readable format (templates selected, all `template_params` values for each template), then explicitly ask for confirmation. Do NOT submit until the user confirms. This applies **every time** a `magic-video` task is created — including multiple calls within the same session. Ask in the conversation language.
```bash
# Without custom params (AI handles all defaults)
narrator-ai-cli task create magic-video --json -d '{
"task_id": "<task_id from video-composing>",
"template_name": ["竖屏·黑金剧集", "横屏·电影剧集"]
}'
# With custom params — key is template name, value is params dict
narrator-ai-cli task create magic-video --json -d '{
"task_id": "<task_id from video-composing>",
"template_name": ["竖屏·合规剧集"],
"template_params": {
"竖屏·合规剧集": {
"segment_count": 0,
"bottom_disclaimer_text": "本故事纯属虚构 请勿模仿",
"vertical_text_content": "影视效果 请勿模仿 合理安排生活"
}
}
}'
```
**Output**: `sub_tasks` array — one entry per template, each with a rendered video URL.
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: 471k | 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: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |