Skill doesn't activate

Ensure SKILL.md is at the cloned dir root and Claude Code restarted.

freemcplab / Каталог / Песочница / narrator-ai-cli-skill

● Сообщество GridLtd-ProductDev ⚡ Сразу

narrator-ai-cli-skill

Name: narrator-ai-cli-skill (Claude Skill)
Author: GridLtd-ProductDev

автор GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill

Agent skill for the Narrator AI video-narration CLI — Claude drives end-to-end narration runs from the command line.

narrator-ai-cli-skill teaches Claude how to use narrator-ai-cli, the CLI client for the Narrator AI video narration API. It wraps the flags, common flows, and output handling so Claude can assemble narration prompts, kick off jobs, poll for completion, and place the output files in sensible locations — useful when you want to batch-narrate a series of videos without hand-running the CLI.

▶ Смотреть демо 📦 Установить 💡 Сценарии

Зачем использовать

Ключевые функции

Wraps narrator-ai-cli flags and subcommands
Handles job submission + polling patterns
Output-file placement conventions
Batch narration across multiple source videos
Fails loudly when API key or config is missing

Живое демо

Как выглядит на практике

narrator-ai-cli-skill.replay ▶ готово

0/0

Установка

Репозиторий автора · Официальная документация Claude Skills

Сценарии использования

Реальные сценарии: narrator-ai-cli-skill

How to narrate a single video from a brief

👤 Creators and editors using Narrator AI for VO ⏱ ~15 min beginner

Когда использовать: You have a video and a draft voice-over script and want narration produced via the CLI.

Поток

Stage inputs

Given my video scene_01.mp4 and the VO script script.md, run narrator-ai-cli and save the output to ./narrations/.✓ Скопировано

→ CLI invocation with correct flags
Wait and verify

Poll until the job is done, then confirm the output file exists and has audio.✓ Скопировано

→ Output file present with non-zero duration

Итог: Narration file ready to drop into your editor.

Подводные камни

Long jobs time out in the shell — Use the CLI's async mode + poll instead of a blocking call

Сочетать с: filesystem

Batch-narrate a series of scenes

👤 Teams with multi-scene projects ⏱ ~45 min intermediate

Когда использовать: You have 10+ scenes with per-scene scripts and need them narrated consistently.

Поток

Walk the project structure

Find all scene_*.mp4 + scene_*.md pairs under project/ and queue narration for each.✓ Скопировано

→ Enumerated pairs + job queue
Run serially or in parallel

Run up to 3 jobs in parallel; rate-limit per the API allowance.✓ Скопировано

→ Controlled concurrency
Report results

Produce a table: scene, status, duration, output path.✓ Скопировано

→ Clear completion table

Итог: Whole project narrated in one run with clear status.

Подводные камни

Hitting API limits mid-batch — Respect upstream rate limits; back off on 429

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

narrator-ai-cli-skill + filesystem

Find inputs automatically and drop outputs in structured folders

Walk project/, narrate every scene, output to project/narrations/.✓ Скопировано

narrator-ai-cli-skill + claude-shorts-skill

Add AI narration to Short clips generated by claude-shorts

For each rendered Short, narrate an intro line and mix it in.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
cli-invocation	inputs (video+script) + flags	Every narration run	narrator-ai API usage
job-polling	job id	After submission	minimal
batch-orchestration	list of jobs	Multi-scene projects	depends on batch size

Стоимость и лимиты

Во что обходится

Квота API: depends on Narrator AI tier
Токенов на вызов: minimal LLM tokens; real cost is API minutes
Деньги: API billed by Narrator AI
Совет: Narrate final scripts only; iterate text in LLM first

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Narrator AI API key in env var; never inline

Исходящий трафик: Narrator AI endpoints

Uploaded video/audio passes through third-party service; check data handling policies

Устранение неполадок

Частые ошибки и исправления

CLI command not found

Install narrator-ai-cli and make sure it's on PATH where Claude Code runs.

Проверить: which narrator-ai-cli

401 from Narrator API

Set NARRATOR_API_KEY (or the env var the CLI expects).

Проверить: env | grep NARRATOR

Альтернативы

narrator-ai-cli-skill в сравнении

Альтернатива	Когда использовать	Компромисс
claude-shorts-skill	You want a full long-to-short pipeline, not just narration	Pipeline vs single-purpose

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills