🧠 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 merlinyang@gridltd.com 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:
-
"Create a narration video for The Shawshank Redemption"
-
"Show me what movies are available"
-
"Make 5 narration videos for different action movies"
-
"Use a comedy template and generate a narration"
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
-
CLI: narrator-ai-cli v1.0.0+
-
Python: 3.10+
-
Dependencies: typer, httpx[socks], httpx-sse, pyyaml, rich
-
API key: Contact us to get one
Links
Contact
Need an API key or help?
-
📧 Email: merlinyang@gridltd.com
-
💬 WeChat: Scan the QR code below
License
MIT