narrator-ai-cli-skill

Generate movie narration videos via the narrator-ai-cli command-line tool and NarratorAI API.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill narrator-ai-cli-skill-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: narrator-ai-cli-skill
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/narrator-ai-cli-skill
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill narrator-ai-cli-skill-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating movie narration or film commentary videos normally requires manual script writing, voiceover recording, clip editing, and BGM mixing. This Skill automates the entire pipeline through the narrator-ai-cli tool, from movie selection to final video composition. ## Core Features & Use Cases - End-to-End Video Generation: Search built-in movies or upload custom files, pick from 90+ narration templates, 146 BGM tracks, and 63 dubbing voices, then generate scripts and compose videos asynchronously. - Multiple Workflows: Supports Hot Drama (built-in movies), Original Mix (custom uploads), and New Drama (manual clip uploads) modes, plus standalone voice cloning and text-to-speech tasks. - Use Case: A content creator wants to produce a suspense-style narration video for a classic film. The agent searches the movie catalog, selects a template, BGM, and voice, creates the script task, polls until completion, composes the video, and returns a downloadable URL. ## Quick Start Use narrator-ai-cli to create a narration video for the movie Inception with a suspense template, then poll the task status and download the finished video.

Frequently Asked Questions about narrator-ai-cli-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a movie narration video with narrator-ai-cli?▼

Install the CLI via pip, set your API key with narrator-ai-cli config set app_key, then list movies and templates, run task create-script with the selected IDs, poll task status until completed, and run task compose-video to get the final video URL.

How to use a custom movie file for narration generation?▼

Upload your movie with narrator-ai-cli file upload to receive a file_id, then run task create-script with --mode original_mix and that file_id along with template, BGM, and dubbing IDs. The remaining polling and composition steps match the built-in movie workflow.

Does narrator-ai-cli support voice cloning and text-to-speech?▼

Yes, the CLI provides standalone tasks for both. Upload a voice sample and run task clone-voice to create a custom voice, or run task tts with text, a dubbing ID, speed, and volume parameters to synthesize speech.

Why is my narrator-ai-cli task stuck in processing status?▼

Script generation and video composition are asynchronous and can take 5-15 minutes depending on complexity. Poll task status every 10-15 seconds; if a task remains processing for over 30 minutes, check API status or contact support.

What are the limitations of narrator-ai-cli?▼

The CLI requires a NarratorAI API key obtained by contacting the provider, depends on the external NarratorAI API for all processing, and stores uploaded files on NarratorAI servers. Rate limits and server errors may interrupt task execution.