Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
chunpu avatar

Text Storyboard

  • 84 installs
  • 32 repo stars
  • Updated April 1, 2026
  • chunpu/agent-skills

Translates a script or novel into concrete visual storyboards with physical actions, camera movement, and lighting, each clip capped at 15 seconds.

About

Turns abstract literary text into concrete audiovisual storyboard descriptions using physical actions, continuous motion, directed camera moves, and specific lighting. A developer uses it as the creative starting point before generating video prompts.

  • Rules favor concrete physical actions over abstract emotion
  • Each storyboard segment strictly capped at a 15-second clip

Text Storyboard by the numbers

  • 84 all-time installs (skills.sh)
  • Ranked #811 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/chunpu/agent-skills --skill text-storyboard

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs84
repo stars32
Last updatedApril 1, 2026
Repositorychunpu/agent-skills

What it does

Translates a script or novel into concrete visual storyboards with physical actions, camera movement, and lighting, each clip capped at 15 seconds.

Files

SKILL.mdMarkdownGitHub ↗

文字分镜——从剧本到画面的翻译层

这是整套系统的创意起点。不是把剧本复述一遍,而是像给团队讲戏一样,把脑海中的画面完整描述出来。

核心任务举例

剧本写"他站在站台,火车缓缓远去",文字分镜要把它变成: 黄昏的火车站,广播里传来列车即将出发的提示音。他站在黄色安全线外,手里攥着一张皱巴巴的车票。火车鸣笛一声,车轮开始缓缓转动,站台上的风扬起他的衣角。镜头从他的手慢慢上摇到他的脸,他的目光追随着火车远去的方向,嘴唇微微动了动却没说出话。暖黄色的夕阳从他背后斜照过来,在轨道上拉出长长的影子。

文字分镜规则

1. 用具体的物理动作,不用抽象概念

  • ❌ 错误:"她很悲伤"
  • ✅ 正确:"她的肩膀微微颤抖,手指无意识地抠着沙发扶手的布料"

2. 用连续的动作链,让画面"动起来"

  • 人物的动作要有先后顺序,形成连贯的运动流
  • 不要孤立地描述单个动作

3. 镜头运动要有明确方向

  • 推/拉/摇/移/跟,要有起点和终点
  • 描述清楚镜头从哪里到哪里

4. 光影描述要具体到方向、色温、强度

  • 方向:从左侧打来/从头顶落下/从窗外透进
  • 色温:3200K暖光/5600K日光/冷白路灯光
  • 强度:柔和/强烈/微弱/刺眼

5. 所有维度融合叙述

画面内容、人物动作、台词声音、镜头运动、光影氛围——不分条列举,用自然流畅的叙述融合在一起。

6. 严格控制15秒时长

  • 每段文字分镜最终对应一个15秒的视频clip
  • 描述的动作、镜头运动、情节发展要精确控制在15秒内可以完成
  • 避免描述过于复杂、需要更长时间才能呈现的内容

翻译层的意义

下游的分镜师不需要理解剧本的叙事意图,只需要把文字分镜描述的画面忠实地转写成 Seedance 2.0 能理解的提示词格式。创意判断集中在文字分镜阶段,分镜师专注于技术执行。

文字分镜输出格式

每15秒文字分镜对应一个15秒视频clip,一集可能有多个clip

# 文字分镜 - [作品名称]

## Clip 1

### 基础信息
- 人物:[人物描述]
- 场景:[场景描述]
- 时长:15秒
- 内容概述:[这段Clip的核心内容概括]

### 分镜列表
- [时间区间1]: [画面描述,融合动作、镜头、光影、声音]
- [时间区间2]: [画面描述,融合动作、镜头、光影、声音]
- [时间区间3]: [画面描述,融合动作、镜头、光影、声音]
- ...(根据剧情需要灵活划分时间区间)

## Clip 2

### 基础信息
- 人物:[人物描述]
- 场景:[场景描述]
- 时长:15秒
- 内容概述:[这段Clip的核心内容概括]

### 分镜列表
- [时间区间1]: [画面描述,融合动作、镜头、光影、声音]
- [时间区间2]: [画面描述,融合动作、镜头、光影、声音]
- [时间区间3]: [画面描述,融合动作、镜头、光影、声音]
- ...(根据剧情需要灵活划分时间区间)

...

说明:时间区间由剧情节奏灵活决定,没有固定数量和时长划分,只要总时长控制在15秒即可。

单镜时长参考指南

  • 短剧:1-3秒;爆款爽剧≈1秒,冲突反转0.3-0.8秒
  • 国产长剧:4-8秒;都市生活5-8秒,古装/刑侦3-6秒
  • 国漫:2-5秒;3D动作2-4秒,2D国风3-6秒,打斗高潮可低至1秒内

默认参考短剧的镜头时长设计,因为现在流行快节奏

节奏选择

  • 快节奏:动作戏、追逐戏、高潮段落,短镜头快速切换
  • 慢节奏:情感戏、回忆杀、氛围营造,长镜头慢慢推进

文字分镜示例

示例:竹林剑斗(快节奏)

输入(剧本/小说)
女剑仙和反派在竹林打斗。
输出(文字分镜)

文字分镜 - 竹林剑斗

Clip 1

基础信息

  • 人物:女剑仙(白衣,执长剑)、反派(黑袍,握鬼头刀)
  • 场景:正午的竹林
  • 时长:15秒
  • 内容概述:女剑仙与反派在竹林中激烈交手

分镜列表

  • 0-1s: 眼睛极致特写,女剑仙瞳孔骤然收缩,眼神如利刃般锁定前方,5600K日光在她眼中反射出剑刃的寒光,呼吸微微急促
  • 1-2s: 镜头快速推近,中景,女剑仙白衣飘飞,右手握剑鞘,左手拔剑出鞘,剑鸣清越入耳,阳光打在剑刃上反射出刺眼的光芒
  • 2-3s: 反打镜头,反派特写,黑袍在风中鼓动,鬼头刀从右侧斜劈而下,刀风带起地上的落叶,低角度仰拍显气势
  • 3-4s: 跟拍镜头,女剑仙身形一晃,如白鹤腾空跃起,镜头从下往上跟拍,白衣在阳光下如云朵般舒展
  • 4-5s: 慢镜头,剑光如闪电般划过,侧光打在剑刃上,几根竹子被齐根斩断,竹叶在空中四散纷飞
  • 5-6s: 特写,女剑仙脚尖轻轻点在一片飘落的竹叶上,轻盈落地,镜头从脚慢慢上摇到她的脸
  • 6-7s: 中景,反派一刀砍空,鬼头刀重重劈在竹身上,竹子应声而断,碎屑四溅,镜头轻微震动增强冲击力
  • 7-8s: 侧面跟拍,女剑仙纵身冲向反派,长剑直指对方心口,镜头快速平移,阳光从侧面打来,在她身上镀上一层金边
  • 8-9s: 特写碰撞,反派举刀格挡,铛的一声巨响,火花四溅,镜头捕捉刀剑相撞的瞬间,慢放0.5倍
  • 9-10s: 360度环绕镜头,女剑仙在空中旋身,剑花挽起,白衣随之旋转成一个圆,镜头围绕她快速旋转
  • 10-11s: 中景跟拍,反派被逼退三步,脚步踉跄,嘴角溢出一丝鲜血,镜头紧随其后,营造压迫感
  • 11-12s: 快切镜头,女剑仙乘胜追击,剑招如行云流水,每一招都直击要害,镜头快速切换不同角度
  • 12-13s: 特写,反派身上添了几道伤口,黑袍被鲜血染红,镜头从伤口快速移到他惊恐的脸上
  • 13-14s: 低角度仰拍,女剑仙使出绝杀,剑光如银河倾泻而下,逆光拍摄,她如同天神下凡
  • 14-15s: 定格特写,剑尖停在反派咽喉前一寸,风卷竹叶从两人之间飘落,镜头静止3秒,营造紧张感

关键要求

1. 避免抽象词汇:悲伤、高兴、紧张、害怕、两眼放光、面色铁青——这些都不要直接写,要通过动作、表情、光影来表现 2. 画面要有始有终:每个分镜片段要有清晰的起始和结束 3. 保持叙述流畅:像在描述一个正在发生的场景,而不是列清单 4. 镜头与内容同步:镜头运动要服务于内容,为情绪和叙事服务 5. 精确控制15秒时长:每个Clip的内容必须严格控制在15秒内完成,动作和镜头运动的节奏要符合15秒的时间跨度 6. 分镜时间灵活划分:时间区间由剧情节奏灵活决定,没有固定数量和时长划分,只要总时长控制在15秒即可 7. 基础信息完整:每个Clip必须包含人物、场景、时长、内容概述这四项基础信息

使用场景

  • 将小说改编为影视项目时,进行视觉化转化
  • 剧本阶段的文字分镜创作,为后续制作提供明确的画面指引
  • 与团队沟通创作意图,确保所有人对画面有统一认知
  • 为 storyboard-prompt-generator 提供高质量的输入

Related skills

Generative Mediaautomationresearch

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.