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)

windsurf
Searching Database…

3.1K ·GitHub
Narrator-ai-cli-skill
What is this?This is a machine-readable skill file (SKILL.md) that teaches AI agents like Claude Code, Codex, or OpenClaw how to use the narrator-ai-cli tool to automatically produce movie narration videos.
Is this a standalone app, or does it need another tool?It's just the 'brain' - instructions. It requires the separate narrator-ai-cli tool (the 'hands') to actually be installed, since the skill alone can't execute anything.
How do I install this skill?First install narrator-ai-cli and configure your API key, then clone this repo (keeping SKILL.md and the references/ folder together) into your agent's skills directory - for example .skills for Windsurf/Claude Code or .cursor/rules for Cursor.
What do I need before I can use it?You need narrator-ai-cli v1.0.0+, Python 3.10+, several Python packages (typer, httpx, pyyaml, rich), and an API key obtained by emailing the author since there's no self-serve signup.
Can I get an API key instantly, or is there a catch?No self-service signup is shown - you have to email the developer directly or scan a WeChat QR code to request access.
Which AI agents and editors actually work with this?It has been verified on OpenClaw, Windsurf, Claude Code, Cursor, WorkBuddy, QClaw, Youdao Lobster, and Yuanqi AI, and should work with any agent that reads markdown skill files.
Does the skill expose any private data or credentials?SKILL.md documents data flow and privacy details including the API endpoint, how uploaded files are handled, and the scope of credentials used.
What can I actually ask the AI to do once this is set up?You can say things like 'Create a narration video for The Shawshank Redemption', 'Show me what movies are available', or 'Make 5 narration videos for different action movies' - the agent handles the whole pipeline.
What built-in resources does it come with?It ships with roughly 100 movies, 146 BGM tracks, 63 dubbing voices, and over 90 narration templates to draw from when generating videos.
What are the two workflow paths mentioned?There's a Fast Path for Original Narration and a Standard Path for Adapted Narration, each with its own step sequence (0-4 and 0-5 respectively) documented in SKILL.md.
Can it do voice cloning or just narration videos?Yes, the skill also supports standalone tasks like voice cloning and plain text-to-speech, separate from the full video pipeline.
What are similar projects?shuohao-skills, linkedin-skills, Easel, qwen21-nsfw-pose-skill, ai-aug-edu, jianying-editor-skill, h3-storyboard-skill, brag
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