@XAMTO_AI: 有个开源项目叫 narrator-ai-cli-skill,塞进 Claude Code 这类 Agent 里,你就说一句“帮我做《肖申克的救赎》解说视频”,AI 自己把所有活全包了: 自动生成解说脚本,不用你动脑 精准匹配对应电影片段,…
摘要
介绍一个名为 narrator-ai-cli-skill 的开源项目,它可以集成到 Claude Code 等 AI Agent 中,让用户只需一句话就能自动完成电影解说视频的脚本、配音、剪辑、配乐等全流程制作,极大地降低了影视解说号的制作成本。
查看缓存全文
缓存时间: 2026/06/10 19:56
有个开源项目叫 narrator-ai-cli-skill,塞进 Claude Code 这类 Agent 里,你就说一句“帮我做《肖申克的救赎》解说视频”,AI 自己把所有活全包了:
自动生成解说脚本,不用你动脑 精准匹配对应电影片段,不用你剪辑 63种音色配音,还支持声音克隆,不用你录音 90+视觉模板自动套用,不用你设计 146首BGM智能匹配,不用你找歌 直接输出成品,不用你后期 内置93部经典电影素材库,还会提前帮你算成本,工程化程度相当扎实,不是那种玩具级项目。 以前做影视解说号,脚本、配音、剪辑、配乐,每个环节都要人,现在这条链路全断了。人工成本直接归零不是夸张,是字面意思。 想批量起影视号的,这个项目值得认真看一眼。 https://github.com/NarratorAI-Studio/narrator-ai-cli-skill…
NarratorAI-Studio/narrator-ai-cli-skill
Source: https://github.com/NarratorAI-Studio/narrator-ai-cli-skill
🧠 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 pullinside 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: [email protected]
- 💬 WeChat: Scan the QR code below

License
MIT
相似文章
@CycleDecoded: 离谱了兄弟们,做影视解说和短视频拉片的,这波真可以躺平了。 GitHub 上刚挖出来的这个神仙项目,直接把“拉片”这种熬大夜的苦力活,掀桌子全自动了。 项目叫 Lapian-Notes(拉片笔记),是一个把电影直接转换成 AI 辅助笔记的…
Lapian-Notes(拉片笔记)是一个开源的AI辅助电影分析工具,能自动抽帧、生成剧情泳道和情绪曲线,完全本地运行,无需上传数据。
@yunxi0623: https://x.com/yunxi0623/status/2075532304529920468
介绍了6个用于AI编程Agent(如Codex、Claude Code、Cursor)的视频处理技能(HyperFrames、FFmpeg、OpenMontage、Remotion、Video-Use、Manim),覆盖从图文转视频、压缩转码到科普动画等场景,并给出了选择建议和安装指南。
@GitTrend0x: Claude Code 现在也可以编辑视频了! 这个 SKILL 100% 免费且开源。 ✓ 自动创建动画 ✓ 生成不同风格的字幕 ✓ 消除静音、错误和填充词 https://github.com/browser-use/video-us…
video-use is a 100% open-source tool that lets Claude Code edit videos automatically by removing filler words, adding subtitles, color grading, and generating animations. It integrates with Claude Code via a skill and uses ElevenLabs for transcription.
@jinchenma_ai: https://x.com/jinchenma_ai/status/2061835131107860582
文章基于AI Agent(Skill)的工程化方法,提出将确定性的任务固化为脚本,减少大模型运行时的新判断,从而提升稳定性和Token效率。以视频字幕处理为例,展示了四步工程化流程。
@IndieDevHailey: 港大开源 ViMax,AI 一人剧组,一键拍完整长视频! 一句话想法 → 自动生成带剧本、分镜、配音、角色一致的成片! 解决下面的痛点: - 不再几秒短 clip、人物跳脸 - 多 Agent 协作:编剧写故事、导演控镜头、制片保一致、生…
港大开源 ViMax,一个多智能体协作的长视频生成工具,能从一句话生成带剧本、分镜、配音、角色一致的连贯视频,解决短视频碎片化和角色不一致等问题。同时开发者还介绍了Taste-Skill,一个提升AI生成界面审美的前端框架。