#394 by GitHub stars

NarratorAI-Studio/narrator-ai-cli-skill

AI 电影/短剧解说视频自动生成（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.

Writing

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4b17c6f2175b → 4b17c6f2175b

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4b17c6f2175b

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit 4b17c6f2175bd532c92db778a847f8fb6bdd3177

3.2kGitHub stars

93stars in 7 days

1skill in this repository

0commits in 30 days

Heat

6.0

Star growth, last 7 daysAhead of 94% of tracked repositories
Star growth, last 24 hoursAhead of 70% of tracked repositories
Rank movement, last 7 daysAhead of 62% of tracked repositories
Commits, last 30 daysAhead of 0% of tracked repositories
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Individual skills in this repository

narrator-ai-cli /

How it works

narrator-ai-cli

When your agent uses it

AI 电影/短剧解说视频自动生成（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.

What it loads into context

Frontmatter

304 tokens

Always available to the agent

SKILL.md

4,846 tokens

When the skill is activated

Reference documents

15,796 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

Reference Index
Pipeline at a Glance
Agent Rules (mandatory — apply across all steps)
Prerequisites
Core Concepts
Conversation Initiation
Two Workflow Paths
Resource Selection Protocol
Fast Path — High-Level Flow
Standard Path — High-Level Flow
Standalone Tasks
Important Notes
Data & Privacy

Scripts executed separately

.github/workflows/scripts/common.sh

Files

.github/workflows/scripts/common.shruns9,755 bytes
.gitignoreasset31 bytes
.gitleaks.tomlasset5,127 bytes
.trufflehogignoreasset544 bytes
LICENSEasset1,067 bytes
README.mddoc6,324 bytes
README_CN.mddoc6,442 bytes
SKILL.mdcore19,347 bytes
SKILL.mdcore19,347 bytes
SKILL.mdcore19,347 bytes
SKILL.mdcore19,347 bytes
SKILL.mdcore19,347 bytes
imgs/contact.pngasset4,764 bytes
plugin.jsonasset1,601 bytes
references/magic-video.mddoc11,114 bytes
references/operations.mddoc11,490 bytes
references/resources.mddoc6,126 bytes
references/workflows.mddoc16,871 bytes

Read SKILL.md


# narrator-ai-cli — AI Video Narration CLI Skill

CLI client for [Narrator AI](https://openapi.jieshuo.cn) video narration API. Designed for AI agents and developers.

- **CLI repo**: https://github.com/NarratorAI-Studio/narrator-ai-cli
- **Resources preview** (BGM / dubbing / templates): https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc

## Reference Index

This file covers decision flow, the common workflow, and pointers. Detailed lookups live in `references/`:

| Topic | File |
|---|---|
| Resource selection (material / BGM / dubbing / templates) — list commands, response formats, field mapping | `references/resources.md` |

View the complete source on GitHub

Skills included

narrator-ai-cli

Repository facts

License: MIT
Created: Mar 19, 2026
Last pushed: Jul 5, 2026
Forks: 419
Open issues: 3
Project activity: Slowing

Rank over the last 12 weeks

Now #394 · best #330 · down 47 in 30 days

#390 from Oct 31 to Nov 1
#391 on Nov 2
#394 on Nov 3
#388 from Nov 4 to Nov 5
#391 on Nov 6
#394 since Nov 7

69 earlier periods

#414 on Aug 2
#393 on Aug 8
#372 on Aug 9
#381 on Aug 10
#374 on Aug 11
#369 on Aug 12
#373 on Aug 13
#372 on Aug 14
#369 on Aug 15
#367 on Aug 16
#359 on Aug 17
#366 on Aug 18
#362 on Aug 19
#363 on Aug 20
#362 on Aug 21
#358 on Aug 22
#361 on Aug 23
#363 on Aug 24
#361 from Aug 25 to Aug 26
#363 on Aug 27
#365 on Aug 28
#360 on Aug 29
#353 on Aug 30
#360 on Aug 31
#364 on Sep 1
#355 on Sep 2
#356 on Sep 3
#351 on Sep 4
#353 on Sep 5
#342 on Sep 6
#351 on Sep 7
#354 on Sep 9
#353 on Sep 10
#349 on Sep 11
#353 from Sep 12 to Sep 13
#356 on Sep 14
#359 on Sep 15
#358 on Sep 16
#359 on Sep 18
#364 from Sep 20 to Sep 21
#367 on Sep 22
#362 on Sep 23
#360 on Sep 24
#360 on Sep 26
#360 on Sep 28
#343 on Sep 29
#335 on Sep 30
#334 on Oct 1
#337 on Oct 2
#333 on Oct 3
#330 on Oct 4
#337 from Oct 5 to Oct 6
#347 on Oct 8
#351 on Oct 9
#343 on Oct 10
#346 on Oct 11
#354 from Oct 12 to Oct 13
#356 on Oct 14
#352 on Oct 15
#353 on Oct 17
#360 on Oct 18
#365 on Oct 20
#366 from Oct 21 to Oct 22
#367 on Oct 23
#363 on Oct 24
#375 on Oct 25
#384 on Oct 28
#387 on Oct 29
#389 on Oct 30

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 2, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 4 notes

SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
6 dangerous shell commandsin 1 file: .github/workflows/scripts/common.sh:45
57 network referencesin 7 files: README.md:9 README_CN.md:5 SKILL.md:22 and 4 more
No hidden or obfuscated text
No instruction overrides
1 executable scriptin 1 file: .github/workflows/scripts/common.sh:1
3 references to secretsin 3 files: .gitleaks.toml:13 plugin.json:35 references/magic-video.md:29
No requests to vote in Hot

Show all 67 signals by file

`.github/workflows/scripts/common.sh`

Executable scriptline 1
```
#!/usr/bin/env bash
```
Dangerous shell operationline 45
```
rm -f "$body_file" "$headers_file"
```
Dangerous shell operationline 52
```
rm -f "$body_file" "$headers_file"
```

Dangerous shell operationline 183

# Use git rm to properly stage the deletion for commit.

Dangerous shell operationline 188

git -C "${repo_dir}" rm -f --ignore-unmatch -- "${target_path}" >/dev/null 2>&1 || true

Dangerous shell operationline 189

# Always remove from disk: git rm --ignore-unmatch returns success but

Dangerous shell operationline 191
```
rm -f "${target_fs_path}"
```

`.gitleaks.toml`

Access to secretsline 13
```
[Credential-related source omitted]
```

`README.md`

Network accessline 9

A machine-readable skill file (`SKILL.md`) that teaches AI agents how to use the [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli) tool for automated video narration production.

Network accessline 34

pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"

Network accessline 37

> See [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli) for detailed installation options.

Network accessline 53

mkdir -p ~/.openclaw/skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 54

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 60

mkdir -p /path/to/your/project/.skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 61

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 67

mkdir -p /path/to/your/project/.cursor/rules git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 68

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 74

mkdir -p /path/to/agent/skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 75

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 157

- 📦 [narrator-ai-cli CLI repo](https://github.com/NarratorAI-Studio/narrator-ai-cli)

Network accessline 158

- 📖 [Resource preview (Feishu Docs)](https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc)

Network accessline 159

- 🦞 [OpenClaw agent framework](https://github.com/openclaw/openclaw)

`README_CN.md`

Network accessline 5

> 安装这个 Skill，你的小龙虾（OpenClaw）就能理解如何使用 [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli) 来制作电影解说视频。对着 AI 说一句「帮我做一个电影解说」，剩下的交给它。

Network accessline 34

pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"

Network accessline 37

> 详细安装说明见 [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli)

Network accessline 53

mkdir -p ~/.openclaw/skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 54

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 60

mkdir -p /path/to/your/project/.skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 61

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 67

mkdir -p /path/to/your/project/.cursor/rules git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 68

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 74

mkdir -p /path/to/agent/skills git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 75

git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \

Network accessline 157

- 📦 [narrator-ai-cli 命令行工具](https://github.com/NarratorAI-Studio/narrator-ai-cli)

Network accessline 158

- 📖 [资源预览（飞书文档）](https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc)

Network accessline 159

- 🦞 [OpenClaw Agent 框架](https://github.com/openclaw/openclaw)

`SKILL.md`

Network accessline 22

- name: narrator-ai-cli         type: pip         spec: "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"

Network accessline 23

type: pip         spec: "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"     requires:

Network accessline 24

spec: "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"

Network accessline 34

CLI client for [Narrator AI](https://openapi.jieshuo.cn) video narration API. Designed for AI agents and developers.

Network accessline 36

- **CLI repo**: https://github.com/NarratorAI-Studio/narrator-ai-cli

Network accessline 37

- **Resources preview** (BGM / dubbing / templates): https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc

Network accessline 108

- "I'll upload my own video + SRT" → guide through `file upload` 3. **Defer the Fast vs Standard path question** until source material is confirmed. Asking both at once forces a decision the user has no context for yet. 4. **Optionally shar

Network accessline 110

4. **Optionally share the visual resources preview link** (BGM / dubbing / templates browsable visually): https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc — but only if the user wants to browse, not as a wall of links upfront.

Network accessline 241

- **API endpoint**: All requests go to `https://openapi.jieshuo.cn`. No third-party services.

`plugin.json`

Network accessline 6

"name": "NarratorAI-Studio",     "email": "merlinyang@gridltd.com",     "url": "https://github.com/NarratorAI-Studio"

Network accessline 7

"email": "merlinyang@gridltd.com",     "url": "https://github.com/NarratorAI-Studio"   },

Network accessline 8

"url": "https://github.com/NarratorAI-Studio"

Network accessline 11

"repository": {     "type": "git",     "url": "https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git"

Network accessline 12

"type": "git",     "url": "https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git"   },

Network accessline 13

"url": "https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git"

Network accessline 28

"name": "narrator-ai-cli",       "type": "pip",       "spec": "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"

Network accessline 29

"type": "pip",       "spec": "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"     }

Network accessline 30

"spec": "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"

Access to secretsline 35
```
[Credential-related source omitted]
```

`references/magic-video.md`

Network accessline 26

> > ```bash > curl -X GET "https://openapi.jieshuo.cn/v2/task/commentary/get_magic_template_info" \

Network accessline 27

> ```bash > curl -X GET "https://openapi.jieshuo.cn/v2/task/commentary/get_magic_template_info" \ >     -H "app-key: $NARRATOR_APP_KEY"

Network accessline 28

> curl -X GET "https://openapi.jieshuo.cn/v2/task/commentary/get_magic_template_info" \

Access to secretsline 29
```
[Credential-related source omitted]
```

`references/resources.md`

Network accessline 34

"story_info": "...",       "character_name": "[柳承龙 (Ryu Seung-ryong), 李荷妮 (Lee Ha-nee), ...]",       "cover": "https://...",

Network accessline 35

"character_name": "[柳承龙 (Ryu Seung-ryong), 李荷妮 (Lee Ha-nee), ...]",       "cover": "https://...",       "video_file_id": "<video_file_id>",

Network accessline 36
```
"cover": "https://...",
```

Network accessline 115

> ⚠<U+FE0F> **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 th

Network accessline 116

> https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc

`references/workflows.md`

Network accessline 158

"completed_at": "2026-...",   "results": {     "tasks": [{"video_url": "https://oss.example.com/.../output.mp4"}]

Network accessline 159

"results": {     "tasks": [{"video_url": "https://oss.example.com/.../output.mp4"}]   }

Network accessline 160

"tasks": [{"video_url": "https://oss.example.com/.../output.mp4"}]

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 56 facts

Executable script in code of a file that runs.github/workflows/scripts/common.sh:1High confidence
Dangerous shell operation in code of a file that runs.github/workflows/scripts/common.sh:45High confidence
Dangerous shell operation in code of a file that runs.github/workflows/scripts/common.sh:52High confidence
Dangerous shell operation in a comment of a file that runs.github/workflows/scripts/common.sh:183Low confidence
Dangerous shell operation in code of a file that runs.github/workflows/scripts/common.sh:188High confidence
Dangerous shell operation in a comment of a file that runs.github/workflows/scripts/common.sh:189Low confidence
Dangerous shell operation in code of a file that runs.github/workflows/scripts/common.sh:191High confidence
Network access in prose of documentationREADME.md:9Low confidence
Network access in code of documentationREADME.md:34Low confidence
Network access in prose of documentationREADME.md:37Low confidence
Network access in code of documentationREADME.md:53Low confidence
Network access in code of documentationREADME.md:54Low confidence
Network access in code of documentationREADME.md:60Low confidence
Network access in code of documentationREADME.md:61Low confidence
Network access in code of documentationREADME.md:67Low confidence
Network access in code of documentationREADME.md:68Low confidence
Network access in code of documentationREADME.md:74Low confidence
Network access in code of documentationREADME.md:75Low confidence
Network access in prose of documentationREADME.md:157Low confidence
Network access in prose of documentationREADME.md:158Low confidence
Network access in prose of documentationREADME.md:159Low confidence
Network access in prose of documentationREADME_CN.md:5Low confidence
Network access in code of documentationREADME_CN.md:34Low confidence
Network access in prose of documentationREADME_CN.md:37Low confidence
Network access in code of documentationREADME_CN.md:53Low confidence
Network access in code of documentationREADME_CN.md:54Low confidence
Network access in code of documentationREADME_CN.md:60Low confidence
Network access in code of documentationREADME_CN.md:61Low confidence
Network access in code of documentationREADME_CN.md:67Low confidence
Network access in code of documentationREADME_CN.md:68Low confidence
Network access in code of documentationREADME_CN.md:74Low confidence
Network access in code of documentationREADME_CN.md:75Low confidence
Network access in prose of documentationREADME_CN.md:157Low confidence
Network access in prose of documentationREADME_CN.md:158Low confidence
Network access in prose of documentationREADME_CN.md:159Low confidence
Network access in the frontmatter of the SKILL.mdSKILL.md:22Low confidence
Network access in the frontmatter of the SKILL.mdSKILL.md:23Low confidence
Network access in the frontmatter of the SKILL.mdSKILL.md:24Low confidence
Network access in prose of the SKILL.mdSKILL.md:34Low confidence
Network access in prose of the SKILL.mdSKILL.md:36Low confidence
Network access in prose of the SKILL.mdSKILL.md:37Low confidence
Network access in prose of the SKILL.mdSKILL.md:108Low confidence
Network access in prose of the SKILL.mdSKILL.md:110Low confidence
Network access in prose of the SKILL.mdSKILL.md:241Low confidence
Network access in prose of documentationreferences/magic-video.md:26Low confidence
Network access in prose of documentationreferences/magic-video.md:27Low confidence
Network access in prose of documentationreferences/magic-video.md:28Low confidence
Access to secrets in prose of documentation: a variable, placeholder or call, not a stored valuereferences/magic-video.md:29Low confidence
Network access in code of documentationreferences/resources.md:34Low confidence
Network access in code of documentationreferences/resources.md:35Low confidence

and 6 more

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Native	Frontmatter field user-invocable in SKILL.md	`.claude/skills/<skill-name>/`
Codex	Compatible	Standard SKILL.md SKILL.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Compatible	Standard SKILL.md SKILL.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

[![NarratorAI-Studio/narrator-ai-cli-skill on hotskills](https://hotskills.dev/badge/narratorai-studio-narrator-ai-cli-skill.svg)](https://hotskills.dev/skill/narratorai-studio-narrator-ai-cli-skill/)

NarratorAI-Studio/narrator-ai-cli-skill

History

SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

narrator-ai-cli

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

Skills included

Repository facts

Rank over the last 12 weeks

Before you install

.github/workflows/scripts/common.sh

.gitleaks.toml

README.md

README_CN.md

SKILL.md

plugin.json

references/magic-video.md

references/resources.md

references/workflows.md

How the signals fit together

Works with

You might also use

liyupi/ai-promo-video-maker

YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill

titanwings/distilly

Appllama/appllama-skills

Vincentwei1021/anything2explainer

AgriciDaniel/claude-blog

Explore alternatives and comparisons

Add this badge to your README

`SKILL.md`

`.github/workflows/scripts/common.sh`

`.gitleaks.toml`

`README.md`

`README_CN.md`

`SKILL.md`

`plugin.json`

`references/magic-video.md`

`references/resources.md`

`references/workflows.md`