# Narrator AI CLI

AI 电影/短剧解说视频自动生成（AI 解说大师 CLI Skill）。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film...

- Repository: https://github.com/NarratorAI-Studio/narrator-ai-cli-skill (3086 stars)
- Category: Media
- License: MIT
- Last updated: 2026-07-05
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add NarratorAI-Studio/narrator-ai-cli-skill --skill narrator-ai-cli -g -a claude-code -y`
Codex: `npx skills add NarratorAI-Studio/narrator-ai-cli-skill --skill narrator-ai-cli -g -a codex -y`
Cursor: `npx skills add NarratorAI-Studio/narrator-ai-cli-skill --skill narrator-ai-cli -g -a cursor -y`
Gemini CLI: `npx skills add NarratorAI-Studio/narrator-ai-cli-skill --skill narrator-ai-cli -g -a gemini-cli -y`

## Description

AI 电影/短剧解说视频自动生成（AI 解说大师 CLI Skill）。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现：搜片→选模板→选 BGM→选配音→生成文案→合成视频的全流程自动化。CLI client for Narrator AI video narration API.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# narrator-ai-cli, AI Video Narration CLI Skill

CLI client for [Narrator AI](https://openapi.jieshuo.cn) video narration API. Designed for AI agents and developers.

- **CLI repo**: https://github.com/NarratorAI-Studio/narrator-ai-cli
- **Resources preview** (BGM / dubbing / templates): https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc

## Reference Index

This file covers decision flow, the common workflow, and pointers. Detailed lookups live in `references/`:

| Topic | File |
|---|---|
| Resource selection (material / BGM / dubbing / templates), list commands, response formats, field mapping | `references/resources.md` |
| Full workflow steps with parameter tables and JSON examples (Fast Path + Standard Path) | `references/workflows.md` |
| Magic Video, optional visual template step (catalog, params, language rules) | `references/magic-video.md` |
| Polling pattern, task types, file ops, user account, error codes | `references/operations.md` |

## Pipeline at a Glance

```
                    ┌─── Fast Path (原创文案, cheaper) ───┐
                    │   fast-writing → fast-clip-data     │
  Source material ──┤              ↓                      ├──→ video-composing ──→ (magic-video)
  (material list /  │   [video-composing keys off         │   final MP4 URL       optional visual
   search-movie /   │    fast-clip-data.task_order_num]   │                        template pass
   file upload)     └─────────────────────────────────────┘
                    ┌─── Standard Path (二创文案) ────────┐
                    │   popular-learning → generate-      │
                    │   writing → clip-data               │
                    │              ↓                      │
                    │   [video-composing keys off         │
                    │    generate-writing.task_order_num] │
                    └─────────────────────────────────────┘
```

## Agent Rules (mandatory, apply across all steps)

The rest: https://github.com/NarratorAI-Studio/narrator-ai-cli-skill/blob/HEAD//SKILL.md