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/resources.md
View on GitHub# Resources — Materials, BGM, Dubbing, Templates
> ← Back to [SKILL.md](../SKILL.md)
Detailed list commands, response formats, and field mappings for the four resource types selected before any task. The selection rules (never auto-select, present 5–8 options, etc.) live in **SKILL.md § Resource Selection Protocol**.
---
## 1. Source Files (Video + SRT)
> ⚠️ **Agent behavior**: Use `material list --json --page 1 --size 100` to fetch pre-built materials. Check the `total` field — if `total > 100`, fetch additional pages until all items are retrieved. **Search programmatically using `grep -i` or `python3 -c` piped from the JSON output — do NOT rely on the terminal display, which may be truncated and miss items.** Present **all matching results** (usually ≤ 3) — show title, year, genre, summary. Wait for the user to pick one. If the user wants to upload their own files, guide them through `file upload` for both video and SRT. Do NOT proceed to writing until `video_file_id` and `srt_file_id` are confirmed.
### Option A: Pre-built materials (recommended)
```bash
narrator-ai-cli material list --json --page 1 --size 100
# If total > 100, fetch more pages: --page 2 --size 100, etc.
```
**Response structure:**
```json
{
"total": 101,
"page": 1,
"size": 100,
"items": [
{
"id": "<material_id>",
"name": "极限职业",
"title": "Extreme Job",
"year": "2019",
"type": "喜剧片",
"story_info": "...",
"character_name": "[柳承龙 (Ryu Seung-ryong), 李荷妮 (Lee Ha-nee), ...]",
"cover": "https://...",
"video_file_id": "<video_file_id>",
"srt_file_id": "<srt_file_id>"
}
]
}
```
**Programmatic search** (case-insensitive):
```bash
narrator-ai-cli material list --json --page 1 --size 100 | grep -i "飞驰人生"
narrator-ai-cli material list --json --page 1 --size 100 \
| python3 -c "import json, sys; items = json.load(sys.stdin).get('items', []); \
[print(json.dumps(i, ensure_ascii=False)) for i in items if '飞驰' in i.get('name','') or '飞驰' in i.get('title','')]"
```
**Material → `confirmed_movie_json` field mapping** (construct locally — no `search-movie` needed when the material is found):
| Material field | `confirmed_movie_json` field | Notes |
|---|---|---|
| `name` | `local_title` | Chinese title |
| `title` | `title` | English title |
| `year` | `year` | |
| `type` | `genre` | e.g. `喜剧片` |
| `story_info` | `summary` | |
| `character_name` | `stars` | Parse JSON array string |
| (not in material) | `director` | Omit if unavailable |
### Option B: Upload your own
```bash
narrator-ai-cli file upload ./movie.mp4 --json # returns file_id
narrator-ai-cli file upload ./subtitles.srt --json
narrator-ai-cli file transfer --link "<url>" --json # transfer by HTTP/Baidu/PikPak link
```
Supported formats: `.mp4`, `.mkv`, `.mov`, `.mp3`, `.m4a`, `.wav`, `.srt`, `.jpg`, `.jpeg`, `.png`.
Full file ops (list, info, download, storage, delete) live in `operations.md`.
---
## 2. BGM (Background Music)
> ⚠️ **Agent behavior**: Infer the mood/genre from context, then use `bgm list --search "<keyword>"` to pre-filter. Present **5–8 tracks** (agent decides which fields best represent each — typically name + style). If the user has no preference, recommend **3 tracks** with a one-line reason for each (e.g., "matches the film's fast-paced action tone"). Wait for confirmation. Do NOT use a `bgm` ID in any task until the user confirms.
```bash
narrator-ai-cli bgm list --json # all tracks (146 currently)
narrator-ai-cli bgm list --search "单车" --json
```
The `id` field is what you pass as the `bgm` param when creating clip-data / fast-clip-data tasks.
---
## 3. Dubbing Voice
> ⚠️ **Agent behavior**: Infer the target language from context; if ambiguous, **ask the user** before listing. Run `dubbing list --lang <language>` to filter, then present **all matching voices** (typically < 15 per language) — include name and tags. If the user has no preference, recommend **3 voices** with reasoning (e.g., "neutral tone fits documentary narration"). Wait for confirmation. Do NOT use a dubbing `id` or `dubbing_type` in any task until the user confirms both.
```bash
narrator-ai-cli dubbing list --json # 63 voices, 11 languages
narrator-ai-cli dubbing list --lang 普通话 --json
narrator-ai-cli dubbing list --tag 喜剧 --json
narrator-ai-cli dubbing languages --json
narrator-ai-cli dubbing tags --json
```
Each voice exposes `id` (= `dubbing` param) and `type` (= `dubbing_type` param) — both are required when creating clip tasks.
**Languages available**: 普通话 (39), English (4), 日语 (3), 韩语 (2), Spanish (3), Portuguese (2), German (2), French (2), Arabic (2), Thai (2), Indonesian (2).
> ⚠️ **Language linkage** (recap from SKILL.md): If the chosen voice is non-Chinese, the writing task's `language` param **must** be set to the matching language, and magic-video template text params must also be in the matching language. See `magic-video.md` for the template-text rules.
---
## 4. Narration Style Templates (90+, 12 genres)
> ⚠️ **Agent behavior**: Infer the content genre from context and run `task narration-styles --genre <genre>` to pre-filter. Present **3–5 templates** (agent decides best representative fields). Also share the visual preview link to help the user browse:
> https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc
> If the user has no preference, recommend **3 templates** with a brief style description and reasoning. Wait for confirmation. Do NOT use a `learning_model_id` until the user confirms.
```bash
narrator-ai-cli task narration-styles --json
narrator-ai-cli task narration-styles --genre 爆笑喜剧 --json
```
**Genres**: 热血动作, 烧脑悬疑, 励志成长, 爆笑喜剧, 灾难求生, 悬疑惊悚, 惊悚恐怖, 东方奇谈, 家庭伦理, 情感人生, 奇幻科幻, 传奇人物.
Use the template's `id` directly as `learning_model_id` — **no `popular-learning` step needed**.
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 |