Skillget

narrator-ai-cli-skill

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 9 GitHub stars
Code Gecti
  • Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool provides an AI agent skill file (SKILL.md) that teaches AI coding assistants how to use a separate command-line tool to automatically generate movie narration videos via the Narrator AI API.

Security Assessment
Overall Risk: Low. The repository itself primarily contains markdown instructions rather than executable code. A light code scan found no dangerous patterns, malicious code, or hardcoded secrets. However, it does instruct your system to install a separate CLI tool via pip directly from a GitHub repository. You must provide an API key to use the service, which the CLI saves to your local configuration. While the skill file itself is benign, installing external pip packages directly from Git carries inherent supply chain risks.

Quality Assessment
Overall Quality: Moderate. The project is actively maintained, having received a push very recently, and uses the highly permissive MIT license. The documentation is clear and helpful. On the downside, community visibility and trust are currently very low, with only 9 GitHub stars. Developers should expect limited community support or third-party audits. Additionally, obtaining an API key requires emailing the maintainer directly, which is a non-standard distribution method.

Verdict
Safe to use, but review the linked CLI repository before installing the pip package.
SUMMARY

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/jieshuo-ai/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?

Contact us

License

MIT

Yorumlar (0)

Sonuc bulunamadi