Skip to content
Back to search

narrator-ai-cli-skill

AI电影解说视频自动生成技能(AI解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI配音旁白视频、film commentary、video narration、drama dubbing、movie narration时触发。内置丰富电影素材、BGM、多语种配音音色、解说模板。通过narrator-ai-cli命令行工具实现:搜片选片→选择模板→选BGM→选配音→生成文案→合成视频的全流程自动化。CLI client for Narrator AI (AI解说大师) video narration API. Use when user needs to create AI narration videos, manage narration tasks, browse dubbing/BGM/material resources, or automate video production.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/narratorai-studio-narrator-ai-cli-skill/badge.svg)](/listings/narratorai-studio-narrator-ai-cli-skill)

HTML

<a href="/listings/narratorai-studio-narrator-ai-cli-skill"><img src="/api/listings/narratorai-studio-narrator-ai-cli-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 **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"

---

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 42 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "narrator-ai-cli-skill",
  3. "version": "1.0.5",
  4. "description": "AI电影解说视频自动生成技能(AI解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI配音旁白视频、film commentary、video narration、drama dubbing、movie narration时触发。内置丰富电影素材、BGM、多语种配音音色、解说模板。通过narrator-ai-cli命令行工具实现:搜片选片→选择模板→选BGM→选配音→生成文案→合成视频的全流程自动化。CLI client for Narrator AI (AI解说大师) video narration API. Use when user needs to create AI narration videos, manage narration tasks, browse dubbing/BGM/material resources, or automate video production.",
  5. "author": {
  6. "name": "NarratorAI-Studio",
  7. "email": "merlinyang@gridltd.com",
  8. "url": "https://github.com/NarratorAI-Studio"
  9. },
  10. "license": "MIT",
  11. "repository": {
  12. "type": "git",
  13. "url": "https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git"
  14. },
  15. "keywords": [
  16. "video-narration",
  17. "film-commentary",
  18. "ai-video",
  19. "narrator-ai",
  20. "short-drama",
  21. "content-creation",
  22. "dubbing",
  23. "tts"
  24. ],
  25. "primaryEnv": "NARRATOR_APP_KEY",
  26. "install": [
  27. {
  28. "name": "narrator-ai-cli",
  29. "type": "pip",
  30. "spec": "narrator-ai-cli @ https://github.com/NarratorAI-Studio/narrator-ai-cli/archive/refs/tags/v1.0.0.zip"
  31. }
  32. ],
  33. "requires": {
  34. "bins": ["narrator-ai-cli"],
  35. "env": ["NARRATOR_APP_KEY"]
  36. },
  37. "skills": {
  38. "narrator-ai-cli": {
  39. "path": "SKILL.md"
  40. }
  41. }
  42. }
README.md · README · 172 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🧠 Narrator AI CLI Skill — Teach Your AI Agent to Create Movie Narration Videos
  2. [中文文档](README_CN.md)
  3. > Install this Skill in your AI agent (OpenClaw, Windsurf, WorkBuddy, etc.), then just say "create a movie narration video" — the AI handles the rest.
  4. ## What is this?
  5. 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.
  6. ```
  7. You say: "Create a narration video for Pegasus in a comedy style"
  8. AI executes: Search movie → Select template → Choose BGM → Pick voice → Generate script → Compose video → Return download link
  9. ```
  10. ### How CLI and Skill work together
  11. | | CLI (command-line tool) | Skill (capability description) |
  12. |---|---|---|
  13. | **What it is** | A set of executable commands | Instructions that teach AI how to use those commands |
  14. | **Analogy** | Kitchen tools | A recipe book |
  15. | **Works alone?** | Yes, in terminal manually | No, requires CLI |
  16. In short: **CLI is the hands. Skill is the brain.** Together, the AI agent can produce videos end-to-end.
  17. ---
  18. ## Quick Start
  19. ### Step 1: Install the CLI tool
  20. ```bash
  21. pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"
  22. ```
  23. > See [narrator-ai-cli](https://github.com/NarratorAI-Studio/narrator-ai-cli) for detailed installation options.
  24. ### Step 2: Configure API key
  25. ```bash
  26. narrator-ai-cli config set app_key <your_app_key>
  27. ```
  28. > 📧 Need an API key? Email **merlinyang@gridltd.com** or scan the QR code at the bottom of this page.
  29. ### Step 3: Install the Skill
  30. The skill consists of `SKILL.md` **and** the `references/` directory — both are required. Clone the repo directly into your agent's skills folder:
  31. **OpenClaw:**
  32. ```bash
  33. mkdir -p ~/.openclaw/skills
  34. git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  35. ~/.openclaw/skills/narrator-ai-cli
  36. ```
  37. **Windsurf / Claude Code:**
  38. ```bash
  39. mkdir -p /path/to/your/project/.skills
  40. git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  41. /path/to/your/project/.skills/narrator-ai-cli
  42. ```
  43. **Cursor:**
  44. ```bash
  45. mkdir -p /path/to/your/project/.cursor/rules
  46. git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  47. /path/to/your/project/.cursor/rules/narrator-ai-cli
  48. ```
  49. **Any markdown-reading agent:**
  50. ```bash
  51. mkdir -p /path/to/agent/skills
  52. git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  53. /path/to/agent/skills/narrator-ai-cli
  54. ```
  55. **WorkBuddy / QClaw (Tencent):**
  56. 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).
  57. > 💡 **Tip**: To update the skill later, just run `git pull` inside the cloned directory.
  58. ### Step 4: Start talking!
  59. Once installed, use natural language:
  60. - "Create a narration video for The Shawshank Redemption"
  61. - "Show me what movies are available"
  62. - "Make 5 narration videos for different action movies"
  63. - "Use a comedy template and generate a narration"
  64. ---
  65. ---
  66. ## Tested Platforms
  67. | Platform | Setup | Status |
  68. |----------|-------|--------|
  69. | **OpenClaw** | `git clone` into skills directory | ✅ Verified |
  70. | **Windsurf** | `git clone` into .skills directory | ✅ Verified |
  71. | **WorkBuddy** (Tencent) | Upload SKILL.md + all files in references/ | ✅ Verified |
  72. | **QClaw** (Tencent) | Upload SKILL.md + all files in references/ | ✅ Verified |
  73. | **Youdao Lobster** | `git clone` into skills directory | ✅ Verified |
  74. | **Yuanqi AI** | `git clone` into skills directory | ✅ Verified |
  75. | **Claude Code** | `git clone` into project .skills directory | ✅ Verified |
  76. | **Cursor** | `git clone` into .cursor/rules directory | ✅ Verified |
  77. | Any markdown-skill agent | `git clone` repo, point agent to SKILL.md | ✅ Compatible |
  78. ---
  79. ## Capabilities
  80. | Feature | Details |
  81. |---------|---------|
  82. | Two workflow paths | Adapted Narration and Original Narration |
  83. | Three creation modes | Hot Drama / Original Mix / New Drama |
  84. | Built-in resources | ~100 movies, 146 BGM tracks, 63 dubbing voices, 90+ narration templates |
  85. | Full pipeline | Script → Clip data → Video composing → Visual template |
  86. | Standalone tasks | Voice cloning, text-to-speech |
  87. | Data flow mapping | Which output feeds into which input |
  88. | Error handling | All 18 API error codes with recommended actions |
  89. | Cost estimation | Budget verification before task creation |
  90. ### What's in SKILL.md
  91. | Section | Description |
  92. |---------|-------------|
  93. | Frontmatter | Skill metadata (name, description, requirements) |
  94. | Reference Index | Pointers to detailed lookup tables in `references/` (resources, workflows, magic-video, operations) |
  95. | Pipeline at a Glance | ASCII diagram of Fast Path and Standard Path |
  96. | Agent Rules | Mandatory rules: confirm before acting, language chain, polling pattern, etc. |
  97. | Prerequisites | Assumes `narrator-ai-cli` is installed and `NARRATOR_APP_KEY` is set |
  98. | Core Concepts | Key terms: file_id, task_id, task_order_num, etc. |
  99. | Conversation Initiation | How to open a session and the decision sequence |
  100. | Two Workflow Paths | Fast Path (Original Narration) vs Standard Path (Adapted Narration) |
  101. | Resource Selection Protocol | BGM, dubbing, template selection order and rules |
  102. | Fast Path | Steps 0–4 with parameter notes |
  103. | Standard Path | Steps 0–5 with parameter notes |
  104. | Standalone Tasks | Voice clone and TTS |
  105. | Important Notes | 7 critical gotchas and best practices |
  106. | Data & Privacy | API endpoint, file handling, credentials scope |
  107. ---
  108. ## Requirements
  109. - **CLI**: narrator-ai-cli v1.0.0+
  110. - **Python**: 3.10+
  111. - **Dependencies**: typer, httpx[socks], httpx-sse, pyyaml, rich
  112. - **API key**: Contact us to get one
  113. ## Links
  114. - 📦 [narrator-ai-cli CLI repo](https://github.com/NarratorAI-Studio/narrator-ai-cli)
  115. - 📖 [Resource preview (Feishu Docs)](https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc)
  116. - 🦞 [OpenClaw agent framework](https://github.com/openclaw/openclaw)
  117. ## Contact
  118. Need an API key or help?
  119. - 📧 Email: merlinyang@gridltd.com
  120. - 💬 WeChat: Scan the QR code below
  121. ![Contact us](imgs/contact.png)
  122. ## License
  123. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.