narrator-ai-cli-skill

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 421 🐛 待处理 7 👀 关注 9

GitHub ↗

GitHub 星标 ★ 3189

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

narrator-ai-cli-skill 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队NarratorAI-Studio

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

定价模式🏷️完全免费

价格说明开源项目，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 星标★ 3189

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

代码更新2026-07-05

仓库体积88 KB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3189

技术标签

agent-skills ai-agent ai-video claude-code claude-code-skill

使用教程

难度：入门约 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 <your_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），请按所用工具选择对应命令。