narrator-ai-cli-skill
agent
Pass
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 85 GitHub stars
Code Pass
- Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
Purpose
This tool provides a skill file (SKILL.md) that teaches AI coding agents how to use a separate command-line client. It allows the agent to automate the creation of movie narration videos by searching for media, generating scripts, and returning download links via the Narrator AI API.
Security Assessment
Overall Risk: Medium. The tool itself is just a set of markdown instructions, which the automated code scan confirmed as safe. However, when the AI agent acts on these instructions, it will execute shell commands and make outbound network requests to the Narrator AI API to generate videos. Additionally, you must provide an API key for the service. While no hardcoded secrets exist in the repository, blindly allowing an AI agent to execute CLI commands on your behalf always requires a degree of caution.
Quality Assessment
The project is in excellent health and demonstrates strong community trust, evidenced by 449 GitHub stars. It is actively maintained, with the most recent push occurring just 6 days ago. It is properly licensed under the permissive MIT license, making it suitable for most development environments. The instructions are clear, well-documented, and support a wide variety of popular agent platforms.
Verdict
Use with caution: The skill instructions themselves are safe and well-maintained, but you should review the underlying CLI tool's behavior before allowing your AI agent to execute shell commands and transmit data to an external API.
This tool provides a skill file (SKILL.md) that teaches AI coding agents how to use a separate command-line client. It allows the agent to automate the creation of movie narration videos by searching for media, generating scripts, and returning download links via the Narrator AI API.
Security Assessment
Overall Risk: Medium. The tool itself is just a set of markdown instructions, which the automated code scan confirmed as safe. However, when the AI agent acts on these instructions, it will execute shell commands and make outbound network requests to the Narrator AI API to generate videos. Additionally, you must provide an API key for the service. While no hardcoded secrets exist in the repository, blindly allowing an AI agent to execute CLI commands on your behalf always requires a degree of caution.
Quality Assessment
The project is in excellent health and demonstrates strong community trust, evidenced by 449 GitHub stars. It is actively maintained, with the most recent push occurring just 6 days ago. It is properly licensed under the permissive MIT license, making it suitable for most development environments. The instructions are clear, well-documented, and support a wide variety of popular agent platforms.
Verdict
Use with caution: The skill instructions themselves are safe and well-maintained, but you should review the underlying CLI tool's behavior before allowing your AI agent to execute shell commands and transmit data to an external API.
AI Agent skill for narrator-ai-cli — CLI client for Narrator AI video narration API
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/GridLtd-ProductDev/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
Choose the method for your agent platform:
OpenClaw:
mkdir -p ~/.openclaw/skills/narrator-ai-cli
cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.md
WorkBuddy / QClaw (Tencent):
Upload SKILL.md through the skill management UI.
Windsurf:
cp SKILL.md /path/to/your/project/.skills/narrator-ai-cli/SKILL.md
Claude Code / Cursor:
cp SKILL.md /path/to/your/project/.skills/narrator-ai-cli/SKILL.md
Any markdown-reading agent:
cp SKILL.md /path/to/agent/skills/narrator-ai-cli/SKILL.md
💡 Tip: You can also just give the agent this repo URL — most agents can read the GitHub repo structure and auto-configure.
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 | Native skill loading | ✅ Verified |
| Windsurf | .skills directory | ✅ Verified |
| WorkBuddy (Tencent) | Upload SKILL.md | ✅ Verified |
| QClaw (Tencent) | Upload SKILL.md | ✅ Verified |
| Youdao Lobster | Skill loading | ✅ Verified |
| Yuanqi AI | Skill loading | ✅ Verified |
| Claude Code | SKILL.md in project root | ✅ Verified |
| Cursor | rules/skills directory | ✅ Verified |
| Any markdown-skill agent | Point 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 | 93 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) |
| Architecture | CLI source structure and design choices |
| Core Concepts | Key terms: file_id, task_id, order_num, etc. |
| Workflow Paths | Two complete pipelines with step-by-step commands |
| Prerequisites | How to select resources (materials, BGM, dubbing, templates) |
| Fast Path | Recommended workflow: search → write → clip → compose → magic |
| Standard Path | Full workflow: learn → write → clip → compose → magic |
| Standalone Tasks | Voice clone and TTS |
| Task Management | Query, list, budget, verify, save |
| File Operations | Upload, download, list, delete |
| Error Handling | All 18 API error codes with actions |
| Data Flow | ASCII diagram of complete pipeline |
| Important Notes | 9 critical gotchas and best practices |
Requirements
- CLI: narrator-ai-cli v0.1.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
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found