manga-drama

Comic Drama Generator

Based on Seedance video generation capabilities, specifically for creatingcomic-style short dramas(comic dramas).

Core Features

Protagonist Recognition: Analyze the provided character image and extract character features
Automatic Storyboarding: Automatically generate comic drama storyboard scripts based on the theme
Image-to-Video: Generate videos for each storyboard based on the protagonist image
Comic Style: Built-in comic-style prompt templates
Storyboard Management: Supports custom storyboard scripts

Prerequisites

Need to set the ARK_API_KEY environment variable.

Configuration Method (Recommended)

Copy the configuration template:

cp .canghe-skills/.env.example .canghe-skills/.env

Edit the .canghe-skills/.env file and fill in your API Key:

ARK_API_KEY=your-actual-api-key-here

Or use environment variables

export ARK_API_KEY="your-api-key"

Loading Priority

System environment variables (process.env)
Current directory .canghe-skills/.env
User home directory ~/.canghe-skills/.env

Required dependency skill:seedance-video-generation

Usage

1. Quick Comic Drama Generation (Recommended)

Provide the protagonist image and theme to automatically generate a complete comic drama:

cd ~/.openclaw/workspace/skills/manga-drama
python3 scripts/manga_drama.py generate \
  --image /path/to/character.png \
  --theme "校园日常" \
  --scenes 3 \
  --send-feishu

2. Generate Comic Drama from Script

First create a script, then generate the video:

# 创建脚本模板
python3 scripts/manga_drama.py create-script \
  --output my_drama.json \
  --title "我的漫剧" \
  --character "双马尾女孩" \
  --num-scenes 4

# 编辑脚本文件后生成
python3 scripts/manga_drama.py from-script \
  --script my_drama.json \
  --image /path/to/character.png \
  --send-feishu

Storyboard Templates

Built-in 5 comic drama storyboard types:

Storyboard Type	Name	Description
introduction	Protagonist Entrance	Introduce the protagonist and show character features
action	Action Scene	The protagonist performs an action
emotion	Emotional Expression	Express a certain emotion
interaction	Interaction Scene	Interact with the environment or other elements
ending	Ending Freeze Frame	Comic drama ending, freeze frame

Script Format

{
  "title": "漫剧标题",
  "character": "主角描述",
  "style": "漫画风格",
  "total_scenes": 3,
  "scenes": [
    {
      "scene_number": 1,
      "type": "introduction",
      "name": "主角登场",
      "prompt": "双马尾女孩站在画面中央，微笑看向镜头，漫画风格...",
      "duration": 5,
      "ratio": "9:16",
      "resolution": "1080p"
    }
  ]
}

Parameter Description

generate Command

Parameter	Required	Description
`--image`	✅	Protagonist image path
`--theme`	✅	Comic drama theme/plot description
`--scenes`	❌	Number of storyboards (default 3)
`--output`	❌	Output directory (default ~/Desktop)
`--send-feishu`	❌	Send to Feishu

from-script Command

Parameter	Required	Description
`--script`	✅	Script file path
`--image`	✅	Protagonist image path
`--send-feishu`	❌	Send to Feishu

create-script Command

Parameter	Required	Description
`--output`	✅	Output script file path
`--title`	❌	Comic drama title
`--character`	❌	Protagonist description
`--num-scenes`	❌	Number of storyboards

Usage Examples

Example 1: Generate a Campus Daily Life Comic Drama

python3 scripts/manga_drama.py generate \
  --image ~/Desktop/girl_character.png \
  --theme "校园日常" \
  --scenes 3 \
  --send-feishu

Generate 3 storyboards:

Protagonist Entrance (Campus Gate)
Action scenes (in class/sports)
Ending freeze frame (warm scene)

Example 2: Create a custom comic drama

# 创建脚本
python3 scripts/manga_drama.py create-script \
  --output spring_festival.json \
  --title "春节团圆" \
  --character "白发奶奶" \
  --num-scenes 5

# 编辑 spring_festival.json 文件
# 然后生成
python3 scripts/manga_drama.py from-script \
  --script spring_festival.json \
  --image ~/Desktop/grandma.png \
  --send-feishu

Style features

Comic texture: Hand-drawn style, clear lines
Soft colors: Warm and healing tones
Cinematic composition: Professional image composition
Character consistency: Generated based on the same protagonist image

Technical details

Invocation process

1. 分析主角图片 → 提取角色特征
2. 根据主题 → 生成分镜脚本
3. 每个分镜 → 调用 Seedance 图生视频
4. 可选 → 发送到飞书

Video specifications

Default aspect ratio: 9:16 (vertical screen, suitable for mobile viewing)
Default resolution：1080p
Default duration: 5 seconds per storyboard
Style: Comic/hand-drawn style

Output structure

~/Desktop/drama_我的漫剧/
├── drama_script_xxx.json    # 脚本文件
├── scene_1_introduction.mp4 # 分镜1
├── scene_2_action.mp4       # 分镜2
├── scene_3_emotion.mp4      # 分镜3
└── ...

Notes

Protagonist image quality: Clear character images can achieve better generation results
Prompt optimization: You can edit the script file to customize the prompt for each storyboard
Generation time: About 30-60 seconds per storyboard; multiple storyboards require patience
File size: 1080p videos are large, and sending them via Feishu may require chunked upload

Advanced usage

Custom storyboard prompts

Edit the generated script file and modify the prompt field:

{
  "prompt": "{character}在樱花树下读书，花瓣飘落，漫画风格，温馨治愈..."
}

Batch generate series of comic dramas

Create multiple scripts and generate in batches:

for script in scripts/*.json; do
  python3 scripts/manga_drama.py from-script \
    --script "$script" \
    --image ~/Desktop/character.png
done

About this skill