Skill doesn't activate

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

freemcplab / Verzeichnis / Playground / narrator-ai-cli-skill

● Community GridLtd-ProductDev ⚡ Sofort

narrator-ai-cli-skill

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

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

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

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

Live-Demo

In der Praxis

narrator-ai-cli-skill.replay ▶ bereit

0/0

Installation

Repository des Autors · Offizielle Dokumentation zu Claude Skills

Anwendungsfälle

Praxisnahe Nutzung: narrator-ai-cli-skill

How to narrate a single video from a brief

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

Wann einsetzen: You have a video and a draft voice-over script and want narration produced via the CLI.

Ablauf

Stage inputs

Given my video scene_01.mp4 and the VO script script.md, run narrator-ai-cli and save the output to ./narrations/.✓ Kopiert

→ CLI invocation with correct flags
Wait and verify

Poll until the job is done, then confirm the output file exists and has audio.✓ Kopiert

→ Output file present with non-zero duration

Ergebnis: Narration file ready to drop into your editor.

Fallstricke

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

Kombinieren mit: filesystem

Batch-narrate a series of scenes

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

Wann einsetzen: You have 10+ scenes with per-scene scripts and need them narrated consistently.

Ablauf

Walk the project structure

Find all scene_*.mp4 + scene_*.md pairs under project/ and queue narration for each.✓ Kopiert

→ Enumerated pairs + job queue
Run serially or in parallel

Run up to 3 jobs in parallel; rate-limit per the API allowance.✓ Kopiert

→ Controlled concurrency
Report results

Produce a table: scene, status, duration, output path.✓ Kopiert

→ Clear completion table

Ergebnis: Whole project narrated in one run with clear status.

Fallstricke

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

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

narrator-ai-cli-skill + filesystem

Find inputs automatically and drop outputs in structured folders

Walk project/, narrate every scene, output to project/narrations/.✓ Kopiert

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.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
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

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: depends on Narrator AI tier
Tokens pro Aufruf: minimal LLM tokens; real cost is API minutes
Kosten in €: API billed by Narrator AI
Tipp: Narrate final scripts only; iterate text in LLM first

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Narrator AI API key in env var; never inline

Datenabfluss: Narrator AI endpoints

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

Fehlerbehebung

Häufige Fehler und Lösungen

CLI command not found

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

Prüfen: which narrator-ai-cli

401 from Narrator API

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

Prüfen: env | grep NARRATOR

Alternativen

narrator-ai-cli-skill vs. andere

Alternative	Wann stattdessen	Kompromiss
claude-shorts-skill	You want a full long-to-short pipeline, not just narration	Pipeline vs single-purpose

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen