bynarratorai-studio· 2 skills
AI 电影/短剧解说视频自动生成(AI 解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现:搜片→选模板→选 BGM→选配音→生成文案→合成视频的全流程自动化。CLI client for Narrator AI video narration API.
$npx -y skills add narratorai-studio/narrator-ai-cli-skill --skill narrator-ai-cli-skillInstalls into the current project.
Run `npx skills use "https://github.com/narratorai-studio/narrator-ai-cli-skill" --skill "narratorai-studio/narrator-ai-cli-skill"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/narratorai-studio/narrator-ai-cli-skill" that are relevant to the current task. Run `npx skills add "https://github.com/narratorai-studio/narrator-ai-cli-skill"` and select the relevant skills, then follow their instructions.
| 1 | # 🧠 Narrator AI CLI Skill — Teach Your AI Agent to Create Movie Narration Videos |
| 2 | |
| 3 | [中文文档](README_CN.md) |
| 4 | |
| 5 | > Install this Skill in your AI agent (OpenClaw, Windsurf, WorkBuddy, etc.), then just say "create a movie narration video" — the AI handles the rest. |
| 6 | |
| 7 | ## What is this? |
| 8 | |
| 9 | 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. |
| 10 | |
| 11 | ``` |
| 12 | You say: "Create a narration video for Pegasus in a comedy style" |
| 13 | |
| 14 | AI executes: Search movie → Select template → Choose BGM → Pick voice → Generate script → Compose video → Return download link |
| 15 | ``` |
| 16 | |
| 17 | ### How CLI and Skill work together |
| 18 | |
| 19 | | | CLI (command-line tool) | Skill (capability description) | |
| 20 | |---|---|---| |
| 21 | | **What it is** | A set of executable commands | Instructions that teach AI how to use those commands | |
| 22 | | **Analogy** | Kitchen tools | A recipe book | |
| 23 | | **Works alone?** | Yes, in terminal manually | No, requires CLI | |
| 24 | |
| 25 | In short: **CLI is the hands. Skill is the brain.** Together, the AI agent can produce videos end-to-end. |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Quick Start |
| 30 | |
| 31 | ### Step 1: Install the CLI tool |
| 32 | |
| 33 | ```bash |
| 34 | pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git" |
| 35 | ``` |
| 36 | |
| 37 | > See [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli) for detailed installation options. |
| 38 | |
| 39 | ### Step 2: Configure API key |
| 40 | |
| 41 | ```bash |
| 42 | narrator-ai-cli config set app_key <your_app_key> |
| 43 | ``` |
| 44 | |
| 45 | > 📧 Need an API key? Email **merlinyang@gridltd.com** or scan the QR code at the bottom of this page. |
| 46 | |
| 47 | ### Step 3: Install the Skill |
| 48 | |
| 49 | The skill consists of `SKILL.md` **and** the `references/` directory — both are required. Clone the repo directly into your agent's skills folder: |
| 50 | |
| 51 | **OpenClaw:** |
| 52 | ```bash |
| 53 | mkdir -p ~/.openclaw/skills |
| 54 | git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \ |
| 55 | ~/.openclaw/skills/narrator-ai-cli |
| 56 | ``` |
| 57 | |
| 58 | **Windsurf / Claude Code:** |
| 59 | ```bash |
| 60 | mkdir -p /path/to/your/project/.skills |
| 61 | git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \ |
| 62 | /path/to/your/project/.skills/narrator-ai-cli |
| 63 | ``` |
| 64 | |
| 65 | **Cursor:** |
| 66 | ```bash |
| 67 | mkdir -p /path/to/your/project/.cursor/rules |
| 68 | git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \ |
| 69 | /path/to/your/project/.cursor/rules/narrator-ai-cli |
| 70 | ``` |
| 71 | |
| 72 | **Any markdown-reading agent:** |
| 73 | ```bash |
| 74 | mkdir -p /path/to/agent/skills |
| 75 | git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \ |
| 76 | /path/to/agent/skills/narrator-ai-cli |
| 77 | ``` |
| 78 | |
| 79 | **WorkBuddy / QClaw (Tencent):** |
| 80 | |
| 81 | 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). |
| 82 | |
| 83 | > 💡 **Tip**: To update the skill later, just run `git pull` inside the cloned directory. |
| 84 | |
| 85 | ### Step 4: Start talking! |
| 86 | |
| 87 | Once installed, use natural language: |
| 88 | |
| 89 | - "Create a narration video for The Shawshank Redemption" |
| 90 | - "Show me what movies are available" |
| 91 | - "Make 5 narration videos for different action movies" |
| 92 | - "Use a comedy template and generate a narration" |
| 93 | |
| 94 | --- |
| 95 | |
| 96 | --- |
| 97 | |
| 98 | ## Tested Platforms |
| 99 | |
| 100 | | Platform | Setup | Status | |
| 101 | |----------|-------|--------| |
| 102 | | **OpenClaw** | `git clone` into skills directory | ✅ Verified | |
| 103 | | **Windsurf** | `git clone` into .skills directory | ✅ Verified | |
| 104 | | **WorkBuddy** (Tencent) | Upload SKILL.md + all files in references/ | ✅ Verified | |
| 105 | | **QClaw** (Tencent) | Upload SKILL.md + all files in references/ | ✅ Verified | |
| 106 | | **Youdao Lobster** | `git clone` into skills directory | ✅ Verified | |
| 107 | | **Yuanqi AI** | `git clone` into skills directory | ✅ Verified | |
| 108 | | **Claude Code** | `git clone` into project .skills directory | ✅ Verified | |
| 109 | | **Cursor** | `git clone` into .cursor/rules directory | ✅ Verified | |
| 110 | | Any markdown-skill agent | `git clone` repo, point agent to SKILL.md | ✅ Compatible | |
| 111 | |
| 112 | --- |
| 113 | |
| 114 | ## Capabilities |
| 115 | |
| 116 | | Feature | Details | |
| 117 | |---------|---------| |
| 118 | | Two workflow path |