narrator-ai-cli-skill README

The project's README from github.com/NarratorAI-Studio/narrator-ai-cli-skill. As one markdown file: 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/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:

Tested Platforms

Platform Setup Status
OpenClaw git clone into skills directory ✅ Verified
Windsurf git 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 Lobster git clone into skills directory ✅ Verified
Yuanqi AI git clone into skills directory ✅ Verified
Claude Code git clone into project .skills directory ✅ Verified
Cursor git clone into .cursor/rules directory ✅ Verified
Any markdown-skill agent git clone repo, point agent 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 ~100 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)
Reference Index Pointers to detailed lookup tables in references/ (resources, workflows, magic-video, operations)
Pipeline at a Glance ASCII diagram of Fast Path and Standard Path
Agent Rules Mandatory rules: confirm before acting, language chain, polling pattern, etc.
Prerequisites Assumes narrator-ai-cli is installed and NARRATOR_APP_KEY is set
Core Concepts Key terms: file_id, task_id, task_order_num, etc.
Conversation Initiation How to open a session and the decision sequence
Two Workflow Paths Fast Path (Original Narration) vs Standard Path (Adapted Narration)
Resource Selection Protocol BGM, dubbing, template selection order and rules
Fast Path Steps 0–4 with parameter notes
Standard Path Steps 0–5 with parameter notes
Standalone Tasks Voice clone and TTS
Important Notes 7 critical gotchas and best practices
Data & Privacy API endpoint, file handling, credentials scope

Requirements

Contact

Need an API key or help?

Contact us

License

MIT

narrator-ai-cli-skill (NarratorAI-Studio/narrator-ai-cli-skill)

Searching Database…

3.1K ·GitHub
Narrator-ai-cli-skill
Что это?Это машиночитаемый файл-навык (SKILL.md), который обучает ИИ-агентов вроде Claude Code, Codex или OpenClaw пользоваться инструментом narrator-ai-cli для автоматического создания видео с закадровым пересказом фильмов.
Это самостоятельное приложение или ему нужен другой инструмент?Это только «мозг» — инструкции. Отдельный инструмент narrator-ai-cli («руки») должен быть по-настоящему установлен, поскольку сам навык ничего выполнить не может.
Как установить этот навык?Сначала установите narrator-ai-cli и настройте API-ключ, затем склонируйте этот репозиторий (SKILL.md и папку references/ держите вместе) в каталог навыков вашего агента — например, .skills для Windsurf/Claude Code или .cursor/rules для Cursor.
Что нужно, чтобы начать им пользоваться?Нужны narrator-ai-cli v1.0.0+, Python 3.10+, несколько Python-пакетов (typer, httpx, pyyaml, rich) и API-ключ, который получают, написав автору по почте, — самостоятельной регистрации нет.
Можно ли получить API-ключ мгновенно или есть подвох?Самостоятельной регистрации не предусмотрено — придётся напрямую написать разработчику по почте или отсканировать QR-код WeChat, чтобы запросить доступ.
С какими ИИ-агентами и редакторами это реально работает?Проверено на OpenClaw, Windsurf, Claude Code, Cursor, WorkBuddy, QClaw, Youdao Lobster и Yuanqi AI; должно работать с любым агентом, читающим markdown-файлы навыков.
Раскрывает ли навык какие-либо приватные данные или учётные данные?SKILL.md документирует поток данных и детали приватности, включая API endpoint, порядок обработки загружаемых файлов и объём используемых учётных данных.
Что на самом деле можно поручить ИИ после настройки?Можно сказать, например, «Создай видео с пересказом фильма „Побег из Шоушенка“», «Покажи, какие фильмы доступны» или «Сделай 5 видео с пересказом разных боевиков» — агент берёт на себя весь пайплайн.
Какие встроенные ресурсы идут в комплекте?В комплекте около 100 фильмов, 146 BGM-треков, 63 голоса дубляжа и более 90 шаблонов пересказа, из которых можно выбирать при генерации видео.
Какие два пути рабочего процесса описаны?Есть Fast Path для оригинального пересказа и Standard Path для адаптированного пересказа, каждый со своей последовательностью шагов (0–4 и 0–5 соответственно), описанной в SKILL.md.
Умеет ли он клонировать голос или делает только видео с пересказом?Да, навык поддерживает и отдельные задачи вроде клонирования голоса и простого преобразования текста в речь, отдельно от полного видеопайплайна.
What are similar projects?shuohao-skills, linkedin-skills, Easel, qwen21-nsfw-pose-skill, ai-aug-edu, h3-storyboard-skill, brag, ai-promo-video-maker
Which topics is it in?openclaw-skill, short-drama, windsurf, skill-md, ai-video, voice-cloning, claude-code-skill, tts, content-creation, text-to-speech, agent-skill, openclaw
Creator
NarratorAI-Studio
Size
0.1 MB
Stars
3.1K
Updated
CommitJul 05Releasev1.0.0Apr 02
Age
6mo
Commits · 90 Days