/ Annuaire / Playground / narrator-ai-cli-skill
● Communauté GridLtd-ProductDev ⚡ Instantané

narrator-ai-cli-skill

par 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.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

narrator-ai-cli-skill.replay ▶ prêt
0/0

Installation

Dépôt de l’auteur · Documentation officielle des Skills Claude

Cas d'usage

Usages concrets : narrator-ai-cli-skill

How to narrate a single video from a brief

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

Quand l'utiliser : You have a video and a draft voice-over script and want narration produced via the CLI.

Déroulement
  1. Stage inputs
    Given my video scene_01.mp4 and the VO script script.md, run narrator-ai-cli and save the output to ./narrations/.✓ Copié
    → CLI invocation with correct flags
  2. Wait and verify
    Poll until the job is done, then confirm the output file exists and has audio.✓ Copié
    → Output file present with non-zero duration

Résultat : Narration file ready to drop into your editor.

Pièges
  • Long jobs time out in the shell — Use the CLI's async mode + poll instead of a blocking call
Combiner avec : filesystem

Batch-narrate a series of scenes

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

Quand l'utiliser : You have 10+ scenes with per-scene scripts and need them narrated consistently.

Déroulement
  1. Walk the project structure
    Find all scene_*.mp4 + scene_*.md pairs under project/ and queue narration for each.✓ Copié
    → Enumerated pairs + job queue
  2. Run serially or in parallel
    Run up to 3 jobs in parallel; rate-limit per the API allowance.✓ Copié
    → Controlled concurrency
  3. Report results
    Produce a table: scene, status, duration, output path.✓ Copié
    → Clear completion table

Résultat : Whole project narrated in one run with clear status.

Pièges
  • Hitting API limits mid-batch — Respect upstream rate limits; back off on 429
Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

narrator-ai-cli-skill + filesystem

Find inputs automatically and drop outputs in structured folders

Walk project/, narrate every scene, output to project/narrations/.✓ Copié
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.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
depends on Narrator AI tier
Tokens par appel
minimal LLM tokens; real cost is API minutes
Monétaire
API billed by Narrator AI
Astuce
Narrate final scripts only; iterate text in LLM first

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Narrator AI API key in env var; never inline
Sortie de données : Narrator AI endpoints

Dépannage

Erreurs courantes et correctifs

CLI command not found

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

Vérifier : which narrator-ai-cli
401 from Narrator API

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

Vérifier : env | grep NARRATOR

Alternatives

narrator-ai-cli-skill vs autres

AlternativeQuand l'utiliserCompromis
claude-shorts-skillYou want a full long-to-short pipeline, not just narrationPipeline vs single-purpose

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills