claudeers.

🔓 unclaimed — this page was auto-generated from GitHub. Are you the creator?

Claim this page →
// Claude Skills

narrator-ai-cli-skill

AI 解说大师 — Agent skill;封装 narrator-ai-cli 供 Claude/Codex 等工具调用

Actively maintained
100/100
last commit 4 days ago
last release 3 months ago
releases 1
open issues 2
// install
git clone 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 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 isA set of executable commandsInstructions that teach AI how to use those commands
AnalogyKitchen toolsA recipe book
Works alone?Yes, in terminal manuallyNo, 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 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 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"


Tested Platforms

PlatformSetupStatus
OpenClawgit clone into skills directory✅ Verified
Windsurfgit 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 Lobstergit clone into skills directory✅ Verified
Yuanqi AIgit clone into skills directory✅ Verified
Claude Codegit clone into project .skills directory✅ Verified
Cursorgit clone into .cursor/rules directory✅ Verified
Any markdown-skill agentgit clone repo, point agent to SKILL.md✅ Compatible

Capabilities

FeatureDetails
Two workflow pathsAdapted Narration and Original Narration
Three creation modesHot Drama / Original Mix / New Drama
Built-in resources~100 movies, 146 BGM tracks, 63 dubbing voices, 90+ narration templates
Full pipelineScript → Clip data → Video composing → Visual template
Standalone tasksVoice cloning, text-to-speech
Data flow mappingWhich output feeds into which input
Error handlingAll 18 API error codes with recommended actions
Cost estimationBudget verification before task creation

What's in SKILL.md

SectionDescription
FrontmatterSkill metadata (name, description, requirements)
Reference IndexPointers to detailed lookup tables in references/ (resources, workflows, magic-video, operations)
Pipeline at a GlanceASCII diagram of Fast Path and Standard Path
Agent RulesMandatory rules: confirm before acting, language chain, polling pattern, etc.
PrerequisitesAssumes narrator-ai-cli is installed and NARRATOR_APP_KEY is set
Core ConceptsKey terms: file_id, task_id, task_order_num, etc.
Conversation InitiationHow to open a session and the decision sequence
Two Workflow PathsFast Path (Original Narration) vs Standard Path (Adapted Narration)
Resource Selection ProtocolBGM, dubbing, template selection order and rules
Fast PathSteps 0–4 with parameter notes
Standard PathSteps 0–5 with parameter notes
Standalone TasksVoice clone and TTS
Important Notes7 critical gotchas and best practices
Data & PrivacyAPI 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

Contact

Need an API key or help?

Contact us

License

MIT

// compatibility

Platformscli, api
Operating systems
AI compatibilityclaude
LicenseMIT
Pricingopen-source
Language

// faq

What is narrator-ai-cli-skill?

AI 解说大师 — Agent skill;封装 narrator-ai-cli 供 Claude/Codex 等工具调用. It is open-source on GitHub.

Is narrator-ai-cli-skill free to use?

narrator-ai-cli-skill is open-source under the MIT license, so it is free to use.

What category does narrator-ai-cli-skill belong to?

narrator-ai-cli-skill is listed under skills in the Claudeers registry of Claude-compatible tools.

1 views
1,439 stars
unclaimed
updated 5 days ago

// embed badge

narrator-ai-cli-skill on Claudeers
[![Claudeers](https://claudeers.com/api/badge/narrator-ai-cli-skill.svg)](https://claudeers.com/narrator-ai-cli-skill)

// retro hit counter

narrator-ai-cli-skill hit counter
[![Hits](https://claudeers.com/api/counter/narrator-ai-cli-skill.svg)](https://claudeers.com/narrator-ai-cli-skill)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/Shell249,840MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/Python159,495[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/Python117,790MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/Python77,228MIT[ claude ]

// built by

→ see how narrator-ai-cli-skill connects across the ecosystem