narrator-ai-cli-skill

让 AI 一键生成专业电影解说，赋能视频创作

narrator-ai-cli-skill 是一个为 AI 智能体（如 Claude Code、Codex、Cursor 等）设计的技能包，它封装了 narrator-ai-cli 命令行工具，使 AI 能够直接调用其能力来生成电影解说、视频配音等创意内容。该项目解决了 AI 工具链中缺乏专业内容创作能力的问题，通过标准化的 skill 接口，让 AI 智能体可以无缝集成视频解说生成功能。其核心能力包括：将用户指令转化为 narrator-ai-cli 的具体参数、处理视频内容理解与解说文案生成、支持多种输出格式和风格定制。项目采用 agent-skills 规范，易于安装和扩展，目前处于成长阶段，社区活跃度较高。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2667

维护状态维护中

是否开源是

定价模式 free

项目数据

分类智能体

开发团队NarratorAI-Studio

所属国家

官网地址

GitHubhttps://github.com/NarratorAI-Studio/narrator-ai-cli-skill

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言

技术栈/模型agent-skills,ai-agent,ai-video,claude-code,claude-code-skill,content-creation,cursor,film-commentary,narrator-ai,openclaw,openclaw-skill,short-drama,skill-md,video-narration,windsurf

GitHub 星标★ 2667

30天Star增速

HF 下载量

上线时间2026-03-19 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Python 环境（可用 pip 安装包）
已安装 git
一个支持 markdown 技能的 AI 智能体（OpenClaw、Windsurf、Claude Code、Cursor 或 WorkBuddy/QClaw
可用的 narrator-ai-cli app_key（需向官方申请）

安装与启动步骤

1安装 CLI 工具

Skill 只是说明书，必须依赖 narrator-ai-cli 才能工作，先通过 pip 从 GitHub 仓库安装 CLI。
```
pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"
```
2配置 API 密钥

把申请到的 app_key 写入 CLI 配置，否则后续调用生成接口会失败。
```
narrator-ai-cli config set app_key 
```

3安装 Skill（OpenClaw）

OpenClaw 用户把仓库克隆到 ~/.openclaw/skills 下，目录名建议为 narrator-ai-cli。

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

4安装 Skill（Windsurf/Cl

Windsurf 或 Claude Code 用户克隆到项目的 .skills 目录，把 /path/to/your/project 换成真实项目路径。

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

5安装 Skill（Cursor）

Cursor 用户克隆到项目的 .cursor/rules 目录下，重启或刷新后规则生效。

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

6其他智能体安装

任何可读取 markdown 的智能体，克隆到它约定的 skills 目录即可；无目录约定的按官方文档指定路径。
```
mkdir -p /path/to/agent/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git /path/to/agent/skills/narrator-ai-cli
```
7更新 Skill

后续想升级技能内容，进入克隆下来的目录执行 git pull 即可。
```
cd ~/.openclaw/skills/narrator-ai-cli
git pull
```

关键配置

配置项	必填	说明	示例
`app_key`	是	narrator-ai-cli 调用服务所需的密钥，需向官方申请	`app_key_xxxxxxxxxxxx`

如何确认成功

在智能体中输入“create a movie narration video”类指令，AI 能自动调用 narrator-ai-cli 并最终返回视频下载链接即成功。

常见问题

Q：只安装 Skill 不装 CLI 可以吗？

A：不可以。README 明确说明 Skill 本身不能独立工作，它只是教 AI 如何使用命令，必须搭配已安装并配置好的 narrator-ai-cli 才能真正生成视频。

Q：装 Skill 时只复制 SKILL.md 行不行？

A：不行。Skill 由 SKILL.md 和 references/ 目录共同组成，两者都必须存在，且 references/ 必须作为 SKILL.md 同级的子目录保留，不能把文件拍平。

Q：WorkBuddy / QClaw 怎么安装？

A：这两个腾讯系产品没有命令行安装方式，需要在技能管理界面上传 SKILL.md 和整个 references/ 文件夹，并保持原有目录结构不变。

Q：app_key 从哪里来？

A：README 提示需要向官方申请（原文有“ Need a”的申请提示，具体入口见 narrator-ai-cli 项目说明）。

Q：skill 以后怎么升级？

A：进入克隆下来的技能目录执行 git pull 就能拉取最新版本，更新后无需重新配置 app_key。

注意事项

安装顺序不能颠倒：先装 narrator-ai-cli，再配置 app_key，最后才安装 Skill。
克隆时建议目录名统一为 narrator-ai-cli，避免智能体找不到技能入口。
references/ 目录必须与 SKILL.md 一起克隆，遗漏会导致技能不完整。
不同智能体的技能目录不同（OpenClaw 为 ~/.openclaw/skills，Cursor 为项目下 .cursor/rules），请按所用工具选择对应命令。

核心亮点

无缝集成 Claude Code、Codex 等主流 AI 工具，即装即用
封装 narrator-ai-cli，简化复杂命令，降低使用门槛
支持多种视频内容风格，适配不同创作场景

不足之处

依赖 narrator-ai-cli 的稳定性和功能完整性
文档/社区待观察

适用场景

AI 辅助创作电影解说视频，快速生成文案
在视频制作工作流中自动生成配音脚本
为内容创作者提供灵感生成和初稿草拟

替代项目

claude-code-templates、openai-cookbook、langchain

项目介绍

narrator-ai-cli-skill 是智能体领域的开源项目，由 NarratorAI-Studio 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（2,667）位列前 30%，在智能体分类的 2,520 个项目里位列前 15%。

近 42 天，它的 GitHub 星标从 2,082 增加到 2,667，净增 585。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：AI辅助创作电影解说视频，快速生成文案。同类可对比的替代方案包括 claude-code-templates、openai-cookbook、langchain。

上一篇：build-your-own-openclaw

下一篇：XRP-community-wallet