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와 조합해 10배 효율

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

대안