@XAMTO_AI: There is an open-source project called narrator-ai-cli-skill. Plug it into an agent like Claude Code, and just say 'Help me make a commentary video for The Shawshank Redemption', and the AI handles everything: automatically generates commentary script without you lifting a finger, precisely matches corresponding movie clips, …
Summary
Introducing an open-source project called narrator-ai-cli-skill, which can be integrated into AI agents like Claude Code. With just one sentence, users can automatically complete the entire process of creating a movie commentary video — script, voiceover, editing, background music, etc. — greatly reducing the production cost of film commentary channels.
View Cached Full Text
Cached at: 06/10/26, 07:56 PM
There’s an open-source project called narrator-ai-cli-skill that you can drop into agents like Claude Code. Just say “Make a narration video for The Shawshank Redemption,” and the AI handles everything end-to-end:
- Auto-generates the script – no brainpower needed
- Precisely matches movie clips – no editing required
- 63 voice options, plus voice cloning – no recording
- 90+ visual templates apply automatically – no design work
- 146 background tracks matched intelligently – no searching for music
- Delivers the final video – no post-production
- Comes with a built-in library of 93 classic movies and even estimates costs upfront
The engineering is solid – not a toy project.
Before, running a movie narration channel meant handling scriptwriting, voiceover, editing, and music separately – each step needed a human. Now that whole chain is broken. Saying “labor cost drops to zero” isn’t an exaggeration; it’s literal.
If you want to batch-launch movie narration accounts, this project is worth a serious look.
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 (https://github.com/NarratorAI-Studio/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 (https://github.com/NarratorAI-Studio/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
- 📦 narrator-ai-cli CLI repo (https://github.com/NarratorAI-Studio/narrator-ai-cli)
- 📖 Resource preview (Feishu Docs) (https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc)
- 🦞 OpenClaw agent framework (https://github.com/openclaw/openclaw)
Contact
Need an API key or help?
- 📧 Email: [email protected]
- 💬 WeChat: Scan the QR code below
Contact us
License
MIT
Similar Articles
@CycleDecoded: Unbelievable, folks — for those doing film commentary and short video analysis, you can truly kick back now. This divine project I just dug up on GitHub completely automates the grueling work of shot-by-shot analysis. Called Lapian-Notes, it's an AI-powered tool that turns movies into…
Lapian-Notes is an open-source AI-assisted film analysis tool that automatically extracts frames, generates scene timelines and emotion curves, runs entirely locally, and requires no data uploads.
@yunxi0623: https://x.com/yunxi0623/status/2075532304529920468
Introduces 6 video processing tools (HyperFrames, FFmpeg, OpenMontage, Remotion, Video-Use, Manim) for AI coding agents (such as Codex, Claude Code, Cursor), covering scenarios from converting images/text to video, compression/transcoding, to educational animations, along with selection recommendations and installation guide.
@GitTrend0x: Claude Code can now edit videos too! This SKILL is 100% free and open source. ✓ Automatically create animations ✓ Generate subtitles in different styles ✓ Remove silence, errors, and filler words 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
The article proposes an engineering methodology based on AI Agent (Skill), suggesting that deterministic tasks be solidified into scripts to reduce new decisions made by the large model at runtime, thereby improving stability and token efficiency. Taking video subtitle processing as an example, it demonstrates a four-step engineering process.
@IndieDevHailey: HKU open-sources ViMax — AI one-person film crew, one-click to produce a complete long-form video! One-sentence idea → automatically generates a finished production with script, storyboard, voiceover, and consistent characters! Solves these pain points: - No more short clips of a few seconds where characters change faces - Multi-agent collaboration: screenwriter writes story, director controls shots, producer ensures consistency, generator outputs video...
HKU open-sourced ViMax, a multi-agent collaborative long video generation tool that can generate a coherent video with script, storyboard, voiceover, and consistent characters from a single sentence, solving issues like short video fragmentation and character inconsistency. The developer also introduced Taste-Skill, a frontend framework that improves the aesthetics of AI-generated interfaces.