/ Directorio / Playground / narrator-ai-cli-skill
● Comunidad GridLtd-ProductDev ⚡ Instantáneo

narrator-ai-cli-skill

por GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill

Skill de agente para narrator-ai-cli, la CLI de Narrator AI para narración de videos — Claude ejecuta corridas de narración de extremo a extremo desde la línea de comandos.

narrator-ai-cli-skill enseña a Claude cómo usar narrator-ai-cli, el cliente CLI para la API de narración de video Narrator AI. Encapsula los flags, flujos comunes y manejo de salida para que Claude pueda ensamblar prompts de narración, lanzar trabajos, sondear la finalización y colocar los archivos de salida en ubicaciones sensatas — útil cuando quieres narrar en lote una serie de videos sin ejecutar manualmente la CLI.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

narrator-ai-cli-skill.replay ▶ listo
0/0

Instalación

Repositorio del autor · Documentación oficial de Skills de Claude

Casos de uso

Usos del mundo real: narrator-ai-cli-skill

Cómo narrar un video único desde un brief

👤 Creadores y editores usando Narrator AI para voz en off ⏱ ~15 min beginner

Cuándo usarlo: Tienes un video y un guion de voz en off en borrador y quieres que se produzca la narración vía CLI.

Flujo
  1. Preparar entradas
    Dado mi video scene_01.mp4 y el guion de VO script.md, ejecuta narrator-ai-cli y guarda la salida en ./narrations/.✓ Copiado
    → Invocación CLI con flags correctos
  2. Esperar y verificar
    Sondea hasta que el trabajo esté listo, luego confirma que el archivo de salida existe y tiene audio.✓ Copiado
    → Archivo de salida presente con duración no-cero

Resultado: Archivo de narración listo para introducir en tu editor.

Errores comunes
  • Los trabajos largos se agotan el tiempo en el shell — Usa el modo asincrónico de la CLI + sondeo en lugar de una llamada bloqueante
Combinar con: filesystem

Narrar en lote una serie de escenas

👤 Equipos con proyectos de múltiples escenas ⏱ ~45 min intermediate

Cuándo usarlo: Tienes 10+ escenas con guiones por escena y necesitas que se narren de manera consistente.

Flujo
  1. Recorrer la estructura del proyecto
    Encuentra todos los pares scene_*.mp4 + scene_*.md bajo project/ y encola narración para cada uno.✓ Copiado
    → Pares enumerados + cola de trabajos
  2. Ejecutar en serie o en paralelo
    Ejecuta hasta 3 trabajos en paralelo; limita la velocidad según la asignación de API.✓ Copiado
    → Concurrencia controlada
  3. Reportar resultados
    Produce una tabla: escena, estado, duración, ruta de salida.✓ Copiado
    → Tabla de finalización clara

Resultado: Todo el proyecto narrado en una ejecución con estado claro.

Errores comunes
  • Exceder límites de API durante la ejecución del lote — Respeta los límites de velocidad de upstream; espera al recibir un 429
Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

narrator-ai-cli-skill + filesystem

Encuentra entradas automáticamente y coloca salidas en carpetas estructuradas

Recorre project/, narra cada escena, salida a project/narrations/.✓ Copiado
narrator-ai-cli-skill + claude-shorts-skill

Añade narración AI a clips Short generados por claude-shorts

Para cada Short renderizado, narra una línea de introducción y mézclalo.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
cli-invocation entradas (video+guion) + flags Cada ejecución de narración uso de API narrator-ai
job-polling id de trabajo Después del envío mínimo
batch-orchestration lista de trabajos Proyectos de múltiples escenas depende del tamaño del lote

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
depende del nivel de Narrator AI
Tokens por llamada
tokens LLM mínimos; el costo real es minutos de API
Monetario
API facturado por Narrator AI
Consejo
Narra solo guiones finales; itera el texto en LLM primero

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Clave API de Narrator AI en variable de entorno; nunca incrustada en el código
Salida de datos: Endpoints de Narrator AI

Resolución de problemas

Errores comunes y soluciones

Comando CLI no encontrado

Instala narrator-ai-cli y asegúrate de que está en PATH donde Claude Code se ejecuta.

Verificar: which narrator-ai-cli
Error 401 de API de Narrator

Establece NARRATOR_API_KEY (o la variable de entorno que espera la CLI).

Verificar: env | grep NARRATOR

Alternativas

narrator-ai-cli-skill vs otros

AlternativaCuándo usarlaContrapartida
claude-shorts-skillQuieres un pipeline completo de largo a corto, no solo narraciónPipeline vs propósito único

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills