narrator-ai-cli-skill README

The project's README from github.com/NarratorAI-Studio/narrator-ai-cli-skill. As one markdown file: README.md.

🧠 Narrator AI CLI Skill — Teach Your AI Agent to Create Movie Narration Videos

中文文档

Install this Skill in your AI agent (OpenClaw, Windsurf, WorkBuddy, etc.), then just say "create a movie narration video" — the AI handles the rest.

What is this?

A machine-readable skill file (SKILL.md) that teaches AI agents how to use the narrator-ai-cli tool for automated video narration production.

You say: "Create a narration video for Pegasus in a comedy style"

AI executes: Search movie → Select template → Choose BGM → Pick voice → Generate script → Compose video → Return download link

How CLI and Skill work together

CLI (command-line tool) Skill (capability description)
What it is A set of executable commands Instructions that teach AI how to use those commands
Analogy Kitchen tools A recipe book
Works alone? Yes, in terminal manually No, requires CLI

In short: CLI is the hands. Skill is the brain. Together, the AI agent can produce videos end-to-end.

Quick Start

Step 1: Install the CLI tool

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

See narrator-ai-cli for detailed installation options.

Step 2: Configure API key

narrator-ai-cli config set app_key <your_app_key>

📧 Need an API key? Email [email protected] or scan the QR code at the bottom of this page.

Step 3: Install the Skill

The skill consists of SKILL.md and the references/ directory — both are required. Clone the repo directly into your agent's skills folder:

OpenClaw:

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

Windsurf / Claude Code:

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

Cursor:

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

Any markdown-reading agent:

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

WorkBuddy / QClaw (Tencent):

Upload SKILL.md and the entire references/ folder through the skill management UI, keeping the directory structure intact (references/ must remain a subfolder alongside SKILL.md — do not flatten the files).

💡 Tip: To update the skill later, just run git pull inside the cloned directory.

Step 4: Start talking!

Once installed, use natural language:

Tested Platforms

Platform Setup Status
OpenClaw git clone into skills directory ✅ Verified
Windsurf git clone into .skills directory ✅ Verified
WorkBuddy (Tencent) Upload SKILL.md + all files in references/ ✅ Verified
QClaw (Tencent) Upload SKILL.md + all files in references/ ✅ Verified
Youdao Lobster git clone into skills directory ✅ Verified
Yuanqi AI git clone into skills directory ✅ Verified
Claude Code git clone into project .skills directory ✅ Verified
Cursor git clone into .cursor/rules directory ✅ Verified
Any markdown-skill agent git clone repo, point agent to SKILL.md ✅ Compatible

Capabilities

Feature Details
Two workflow paths Adapted Narration and Original Narration
Three creation modes Hot Drama / Original Mix / New Drama
Built-in resources ~100 movies, 146 BGM tracks, 63 dubbing voices, 90+ narration templates
Full pipeline Script → Clip data → Video composing → Visual template
Standalone tasks Voice cloning, text-to-speech
Data flow mapping Which output feeds into which input
Error handling All 18 API error codes with recommended actions
Cost estimation Budget verification before task creation

What's in SKILL.md

Section Description
Frontmatter Skill metadata (name, description, requirements)
Reference Index Pointers to detailed lookup tables in references/ (resources, workflows, magic-video, operations)
Pipeline at a Glance ASCII diagram of Fast Path and Standard Path
Agent Rules Mandatory rules: confirm before acting, language chain, polling pattern, etc.
Prerequisites Assumes narrator-ai-cli is installed and NARRATOR_APP_KEY is set
Core Concepts Key terms: file_id, task_id, task_order_num, etc.
Conversation Initiation How to open a session and the decision sequence
Two Workflow Paths Fast Path (Original Narration) vs Standard Path (Adapted Narration)
Resource Selection Protocol BGM, dubbing, template selection order and rules
Fast Path Steps 0–4 with parameter notes
Standard Path Steps 0–5 with parameter notes
Standalone Tasks Voice clone and TTS
Important Notes 7 critical gotchas and best practices
Data & Privacy API endpoint, file handling, credentials scope

Requirements

Contact

Need an API key or help?

Contact us

License

MIT

narrator-ai-cli-skill (NarratorAI-Studio/narrator-ai-cli-skill)

Searching Database…

3.1K ·GitHub
Narrator-ai-cli-skill
这是什么？这是一个机器可读的技能文件（SKILL.md），教 Claude Code、Codex 或 OpenClaw 这类 AI 智能体如何使用 narrator-ai-cli 工具自动制作电影解说视频。
这是独立应用，还是需要另一个工具配合？它只是「大脑」——指令。还需要实际安装单独的 narrator-ai-cli 工具（「双手」），因为技能本身无法执行任何操作。
怎么安装这个技能？先安装 narrator-ai-cli 并配置好你的 API 密钥，然后把本仓库（保持 SKILL.md 和 references/ 文件夹在一起）克隆到智能体的技能目录——例如 Windsurf/Claude Code 用 .skills，Cursor 用 .cursor/rules。
使用之前需要准备什么？你需要 narrator-ai-cli v1.0.0 及以上版本、Python 3.10 及以上版本、几个 Python 软件包（typer、httpx、pyyaml、rich），以及通过邮件联系作者获取的 API 密钥，因为没有自助注册渠道。
API 密钥能立刻拿到吗，还是有什么门道？没有提供自助注册入口——你必须直接给开发者发邮件或扫描微信二维码来申请使用权限。
哪些 AI 智能体和编辑器实际适配它？它已在 OpenClaw、Windsurf、Claude Code、Cursor、WorkBuddy、QClaw、Youdao Lobster 和 Yuanqi AI 上验证过，应该也能配合任何会读取 markdown 技能文件的智能体使用。
这个技能会暴露任何隐私数据或凭据吗？SKILL.md 记录了数据流向和隐私细节，包括 API 端点、上传文件的处理方式以及所用凭据的范围。
设置好之后，我能让 AI 具体做什么？你可以这样说：「给《肖申克的救赎》做一个解说视频」、「看看有哪些电影可做」，或者「给 5 部不同的动作片各做一个解说视频」——整个流水线都由智能体处理。
它自带哪些内置资源？它内置了大约 100 部电影、146 首 BGM、63 种配音音色和 90 多个解说模板，生成视频时可以调用。
提到的两条工作流路径是什么？有针对原创解说的快速路径（Fast Path）和针对改编解说的标准路径（Standard Path），各自有独立的步骤序列（分别为 0-4 和 0-5），都记录在 SKILL.md 中。
它能做声音克隆，还是只能做解说视频？能，这个技能还支持声音克隆和纯文本转语音等独立任务，与完整的视频流水线是分开的。
What are similar projects?shuohao-skills, linkedin-skills, Easel, qwen21-nsfw-pose-skill, ai-aug-edu, h3-storyboard-skill, brag, ai-promo-video-maker
Which topics is it in?openclaw-skill, short-drama, windsurf, skill-md, ai-video, voice-cloning, claude-code-skill, tts, content-creation, text-to-speech, agent-skill, openclaw
Creator
NarratorAI-Studio
Size
0.1 MB
Stars
3.1K
Updated
CommitJul 05Releasev1.0.0Apr 02
Age
7mo
Commits · 90 Days