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 搭配，撬动十倍杠杆

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
每次调用 Token 数: 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

替代方案