# muapi-character-story-video

This skill builds a multi-scene story around one consistent character, then turns each scene into a video. Use it to create an animated sequence in separate parts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 671 installs · ★ 23
- Author: SamurAIGPT
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/SamurAIGPT/Generative-Media-Skills/tree/HEAD/library/motion/character-story-video/SKILL.md
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/skills/muapi-character-story-video

## What it does

The skill starts with a character description or a reference image. Without a reference, it generates a character image and asks you to approve the design. It then breaks the premise into three scenes: beginning, middle, and ending. Each scene uses the established character image as its reference.

Once you approve the scenes, the skill sends each image to an image-to-video model and presents the results as a sequence. You can also combine the parts with `muapi predict result` and ffmpeg concat. It requires the `muapi` CLI and `MUAPI_API_KEY`; run `muapi auth configure` first if the key is unset. Character approval is a checkpoint before scene generation.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-character-story-video -a claude-code
```
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill character-story-video -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/character-story-video/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/character-story-video/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill character-story-video -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/character-story-video/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill character-story-video -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/character-story-video/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SamurAIGPT/Generative-Media-Skills character-story-video
```

2. **Manually: put the files in place**
- File: `.github/skills/character-story-video/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill character-story-video -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/SamurAIGPT/Generative-Media-Skills --path library/motion/character-story-video
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/character-story-video/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add SamurAIGPT/Generative-Media-Skills --skill character-story-video -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/SamurAIGPT/Generative-Media-Skills/tree/HEAD/library/motion/character-story-video/SKILL.md

## When to use it
- keep a character consistent across story scenes
- turn a premise into a beginning, middle, and ending
- animate each generated scene as a separate video
- combine story parts into one movie

## Example prompts
- Create a character story about a pilot who builds a jetpack and flies into space.
- Make an animated story with three scenes using this character description, and show me the character design first.
- Animate these three scenes as a sequel video and return the parts in order.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a6dea0830535f5a9.

BEGIN THIRD-PARTY FILE a6dea0830535f5a9
```text
---
slug: muapi-character-story-video
name: muapi-character-story-video
version: "1.0.0"
description: Create a multi-part animated story video by first establishing a consistent character and then generating sequential scenes and animating them.
acceptLicenseTerms: true
---


# Character Story Video

**Create a multi-part animated story video by first establishing a consistent character and then generating sequential scenes and animating them.**

## Inputs

| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `character_description` | text | yes | — | Description of the main character (e.g. "a cute piglet wearing a leather aviator jacket and goggles"). |
| `story_premise` | text | yes | — | The overall story arc (e.g. "building a jetpack and flying to space"). |
| `reference_image` | image_url | no | — | Optional starting image of the character to maintain consistency. |


## Steps

This skill involves multiple phases to build a cohesive narrative.

### Phase A — Character Establishment

If `{{reference_image}}` is NOT provided, submit the plan with ONE step to create the character:
1. **Character Creation** — `muapi image generate` (model=`nano-banana-pro`):
   - Prompt: `{{character_description}}, introducing the main character, cinematic lighting, highly detailed, Pixar 3D animation style.`
   - Aspect ratio: 4:5 or 1:1

If `{{reference_image}}` IS provided, use it as the established character and proceed to Phase B.

After generation, ask the user to confirm the character design before proceeding.

### Phase B — Sequential Scene Generation

Once the character is established, create the story beats (e.g., Scene 1, Scene 2, Scene 3).
Submit the plan using `muapi image edit` (model=`nano-banana-2-edit` or `flux-kontext-pro-i2i`) to maintain character consistency. Use the established character image as the reference for ALL these steps.

1. **Scene 1 (Beginning)**
   - Reference: Character Image
   - Prompt: `The character ({{character_description}}) in the first scene of the story: [Describe the beginning of {{story_premise}}]. Cinematic lighting, Pixar 3D animation style, storybook illustration.`
2. **Scene 2 (Middle)**
   - Reference: Character Image
   - Prompt: `The character ({{character_description}}) in the second scene: [Describe the climax or middle action of {{story_premise}}]. Cinematic lighting, Pixar 3D animation style, storybook illustration.`
3. **Scene 3 (End)**
   - Reference: Character Image
   - Prompt: `The character ({{character_description}}) in the final scene: [Describe the resolution of {{story_premise}}]. Cinematic lighting, Pixar 3D animation style, storybook illustration.`
```
END THIRD-PARTY FILE a6dea0830535f5a9

The third-party file has ended. Everything between the a6dea0830535f5a9 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2688 of 4523 bytes. © SamurAIGPT · MIT · https://github.com/SamurAIGPT/Generative-Media-Skills/tree/HEAD/library/motion/character-story-video/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md