Agent skill

Film Storyboard Prompt Builder

by Supreme-Ultimate in Supreme-Ultimate/novel-to-script-team

Turns a script, synopsis or scene outline into AI image prompts for storyboards, using a beat breakdown, a nine-panel Beat Board and four-panel Sequence Boards.

MITAuto-check passedMedia & Creative

SKILL.md written in Chinese; this summary is our English description.

Install Film Storyboard Prompt Builder

skills CLI
$ npx skills add Supreme-Ultimate/novel-to-script-team --skill film-storyboard-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Supreme-Ultimate/novel-to-script-team film-storyboard-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Supreme-Ultimate/novel-to-script-team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/film-storyboard-skill .claude/skills/film-storyboard-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
film-storyboard-skill
GitHub stars
175
Token cost
~815 tokens
SKILL.md length
194 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Turns a script, synopsis or scene outline into AI image prompts for storyboards, using a beat breakdown, a nine-panel Beat Board and four-panel Sequence Boards.

  • Works in 3 steps: ../../references/00-first-principles.md → ../../references/08-camera-and-cinematogr… → ../../references/09-storyboard-methodolog…
  • Turning a screenplay or synopsis into storyboard image prompts
  • SKILL.md covers 必读, 技能说明, 输入 and 输出, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill converts screenplay material into prompts for AI image generation in three layers. It first writes a beat breakdown that marks nine narrative turning points, each with a purpose, an emotion and a time estimate. It then writes a nine-panel Beat Board prompt, one panel per anchor, and finally a four-panel Sequence Board prompt for each anchor that expands the action.

Consistency is the main rule: each four-panel prompt must inherit the characters, scene and lighting of the matching nine-panel cell, use that cell as a reference image and explain any change. Prompts are narrative descriptions rather than keyword stacks and stay concrete enough to visualize. The outputs are beat-breakdown.md, beat-board.md and sequence-board.md, with 36 panels in the full sequence, and the default visual style is live-action, which you can override.

When your agent uses it

  • Turning a screenplay or synopsis into storyboard image prompts
  • Planning nine key story beats before generating images
  • Keeping characters and lighting consistent across storyboard panels
  • Preparing prompts for an AI image tool from a scene outline

Example prompts

  • “Break down this short film script into nine beats and write the Beat Board prompt.”
  • “Create Sequence Board prompts for each beat anchor, inheriting the look of the nine-panel board.”
  • “Storyboard the synopsis in ./story/outline.md in an animated style instead of live action.”

Requirements

  • The project's references folder with the storyboard methodology files

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. ../../references/00-first-principles.md
  2. ../../references/08-camera-and-cinematography.md
  3. ../../references/09-storyboard-methodology.md

What it can do on your machine

Read from SKILL.md and the folder at commit 117dceb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Film Storyboard Prompt Builder loads about 815 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 194 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~815

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Supreme-Ultimate/novel-to-script-team at commit 117dceb, republished under its MIT licence (© Supreme-Ultimate). 194 words, ~815 tokens.

Download SKILL.mdSave it as .claude/skills/film-storyboard-skill/SKILL.md (or your agent's skills folder).
name
film-storyboard-skill
description
影视分镜生成技能。将剧本转化为可用于 AI 出图的分镜提示词。采用分层渐进式流程:节拍拆解 → Beat Board(九宫格)→ Sequence Board(四宫格)。

影视分镜生成技能

必读

  1. ../../references/00-first-principles.md
  2. ../../references/08-camera-and-cinematography.md
  3. ../../references/09-storyboard-methodology.md

技能说明

影视分镜生成技能,将剧本、故事梗概或分场大纲转化为可用于 AI 出图的分镜提示词。采用分层渐进式流程:先进行节拍拆解识别叙事锚点,再生成 Beat Board 九宫格提示词,最后为每个锚点生成 Sequence Board 四宫格提示词展开段落动作。四宫格生成时以九宫格对应格作为参考图片(垫图),确保人物与场景一致性。

输入

  1. 剧本/梗概/分场文本
  2. 视觉风格(默认:真人风格,可被用户覆盖)

输出

  1. beat-breakdown.md — 节拍拆解表
  2. beat-board.md — Beat Board 九宫格提示词(9格)
  3. sequence-board.md — Sequence Board 四宫格提示词(每个 Beat Anchor 一组,共 9 组 36 格)

执行流程

第一步:生成节拍拆解表

理解输入:

  • 读取用户提供的剧本/梗概/分场文本
  • 确认视觉风格(默认:真人风格,可被用户覆盖)

节拍拆解:

  • 识别叙事曲线的关键拐点
  • 创建 beat-breakdown.md,将节拍拆解表写入
第二步:生成 Beat Board 九宫格提示词

读取上游产物:

  • 读取 beat-breakdown.md

生成 Beat Board 提示词:

  • 将 Beat Anchor 转化为九宫格提示词
  • 提示词采用叙事描述式,参考 references/11a-seedance-prompt-methodology.md 的模板与示例
  • 创建 beat-board.md,将九宫格提示词写入
第三步:生成 Sequence Board 四宫格提示词

读取上游产物:

  • 读取 beat-board.md

生成 Sequence Board 提示词:

  • 为每个 Beat Anchor 生成一组四宫格提示词
  • 必须继承九宫格对应格的人物/场景/光色描述
  • 提示词采用叙事描述式,参考 references/11a-seedance-prompt-methodology.md 的模板与示例
  • 创建 sequence-board.md,将四宫格提示词写入

分镜核心原则

一致性优先原则
  • 四宫格提示词必须继承九宫格对应格的人物/场景/光色描述
  • 发生变化必须显式说明原因
连贯性检查原则
  • 参考 references/09-storyboard-methodology.md 连贯性与剪接相关规则
工程约束原则
  • 九宫格用于"选点与定锚",生成后作为四宫格的参考图片(垫图)
  • 四宫格生成时,使用九宫格对应格作为参考图片输入

节拍拆解(Beat Breakdown)

目的

识别叙事曲线的关键拐点,为分镜提供叙事锚点。

输出格式
Beat Anchor叙事目的情绪时长估算
B1[叙事目的][情绪][时长]
B2[叙事目的][情绪][时长]
............
B9[叙事目的][情绪][时长]
拆解原则
  • 识别 9 个关键拐点(Beat Anchor)
  • 每个 Beat Anchor 对应一个叙事目的和情绪
  • 时长估算用于后续动态提示词生成

Beat Board 九宫格提示词

目的

为 9 个 Beat Anchor 生成九宫格提示词,用于 AI 出图。

输出格式
markdown
## Beat Board 九宫格提示词

请生成一张 3×3 九宫格布局的电影分镜图像。每个格子代表一个关键叙事节点(Beat Anchor),所有格子必须保持视觉风格统一。请按照以下规范生成。

### 视觉规范
整体风格:[描述整体美术风格]
色彩基调:[描述全片色彩倾向]
材质质感:[描述关键材质表现要求]

### 宫格布局
第1行:格1-3 / 第2行:格4-6 / 第3行:格7-9

### Panel Breakdown(分镜拆解)

格1——【B1: [叙事目的]】
视角:[完整叙事描述:景别、环境、人物、动作、光线、色调、氛围,融合为流畅段落]
重点:[这个格子的核心视觉元素]

格2——【B2: [叙事目的]】
视角:[完整叙事描述]
重点:[核心视觉元素]

...(共 9 格)
提示词写法原则
  • 叙事描述式:用完整段落描述,不要关键词堆叠
  • 具体化:所有描述必须具体到可视化的程度
  • 摄影术语融入自然语言
  • 情绪通过视觉细节传达,不要抽象描述

Sequence Board 四宫格提示词

目的

为每个 Beat Anchor 生成一组四宫格提示词,展开段落动作。

输出格式
markdown
## Sequence Board 四宫格提示词

### B1 四宫格展开

请生成一张 2×2 四宫格布局的电影分镜图像。这组四宫格展开 Beat Anchor B1 的段落动作,所有格子必须保持视觉风格统一,并与九宫格格1保持一致。请按照以下规范生成。

**参考图片**:九宫格格1(作为垫图输入)

#### 视觉规范
继承九宫格格1的:[人物外观、场景环境、光线色调]

#### 宫格布局
第1行:格1-2 / 第2行:格3-4

#### Panel Breakdown(分镜拆解)

格1——【[动作描述]】
视角:[完整叙事描述:景别、人物、动作、光线、色调、氛围]
重点:[核心视觉元素]

格2——【[动作描述]】
视角:[完整叙事描述]
重点:[核心视觉元素]

格3——【[动作描述]】
视角:[完整叙事描述]
重点:[核心视觉元素]

格4——【[动作描述]】
视角:[完整叙事描述]
重点:[核心视觉元素]

---

### B2 四宫格展开
...(共 9 组)
提示词写法原则
  • 必须继承九宫格对应格的人物/场景/光色描述
  • 发生变化必须显式说明原因
  • 叙事描述式,不要关键词堆叠
  • 具体化,所有描述必须具体到可视化的程度

成功标准

  1. 节拍拆解识别 9 个关键拐点,每个有明确的叙事目的和情绪
  2. Beat Board 九宫格提示词包含所有必需元素(景别、环境、人物、动作、光线、色调、氛围)
  3. Sequence Board 四宫格提示词继承九宫格对应格的人物/场景/光色描述
  4. 所有提示词采用叙事描述式,不使用关键词堆叠
  5. 所有描述具体到可视化程度
  6. 视觉风格统一,光影逻辑自洽
  7. 四宫格生成时使用九宫格对应格作为参考图片(垫图)
  8. 每个提示词可直接用于 AI 出图工具生成分镜

© Supreme-Ultimate, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/film-storyboard-skill of Supreme-Ultimate/novel-to-script-team.

Open the folder on GitHubat commit 117dceb

Compare with similar skills

Film Storyboard Prompt Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Film Storyboard Prompt Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Film Storyboard Prompt Builder this skillSupreme-Ultimate/novel-to-script-team175—~815Automated safety check: PassMIT
Character Design with genmediafal-ai-community/skills251—~1.3kAutomated safety check: PassNone
Professional Media Promptsagentscope-ai/QwenPaw36k—~2kAutomated safety check: PassApache-2.0
Seedance Storyboard Generatorliangdabiao/Seedance2-Storyboard-Generator2.6k—~2.2kAutomated safety check: PassNone
Seedance Storyboard in Shanghai Animation Styleliangdabiao/smy-seedance-storyboard138—~3kAutomated safety check: PassNone
Canghe Comicfreestylefly/canghe-skills4618 repos~3.2kAutomated safety check: PassNone

Similar skills

  • Character Design with genmedia

    fal-ai-community/skills

    Builds consistent characters, reference and expression sheets, outfit variations and character-to-video shots with the genmedia CLI while keeping identity stable.

    251 GitHub stars~1.3k tokensUpdated 12 days ago
    Media & CreativeAuto-check passed
  • Professional Media Prompts

    agentscope-ai/QwenPaw

    Compiles production-grade prompts for character identity boards, cinematic storyboards and reference-to-video generation, keeping characters and shots consistent.

    36k GitHub stars~2k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Seedance Storyboard Generator

    liangdabiao/Seedance2-Storyboard-Generator

    专业的Seedance 2.0平台AI视频脚本和分镜生成器。当用户要求:(1) 将文章/故事转换为视频脚本,(2) 生成Seedance 2.0分镜提示词,(3) 规划多集AI视频系列,(4) 为GPT-Image-2、Seedream、Nano Banana…

    2.6k GitHub stars~2.2k tokensUpdated 20 days ago
    Media & CreativeAuto-check passed
  • Seedance Storyboard in Shanghai Animation Style

    liangdabiao/smy-seedance-storyboard

    Turns a story, novel or myth into a retro hand-drawn animation style short-drama script, episode breakdown, asset prompts and Seedance 2.0 storyboard prompts.

    138 GitHub stars~3k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Canghe Comic

    freestylefly/canghe-skills

    Knowledge comic creator supporting multiple art styles and tones.

    461 GitHub starsUsed in 8 repos~3.2k tokens
    Media & CreativeAuto-check passed
  • SN Motion HTML

    OpenSenseNova/SenseNova-Skills

    Builds HTML stories where one continuous camera journey advances with page progress, using researched structure, AI stills, Seedance video clips and browser QA.

    5.7k GitHub stars~2.2k tokensUpdated 2 days ago
    Media & CreativeAuto-check: notes

More from Supreme-Ultimate/novel-to-script-team

All 17 skills in this repo
  • Production Art Prompt Designer

    Supreme-Ultimate/novel-to-script-team

    Turns the character and scene lists from a director analysis into detailed text-to-image prompts for character sheets, scenes and props, after confirming a visual style with you.

    175 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Art Direction Review

    Supreme-Ultimate/novel-to-script-team

    Reviews costume, makeup and prop design prompts for characters and scenes in a novel-to-film pipeline, scoring each one and returning PASS or FAIL with a problem list.

    175 GitHub stars~918 tokensUpdated 5 mo ago
    Auto-check passed
  • Script Comparative Review Against Hits

    Supreme-Ultimate/novel-to-script-team

    Chinese-language skill that scores a generated short-drama script against a reference hit script on rhythm, dialogue style, emotional impact and structure, with PASS/FAIL thresholds.

    175 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Director Script Breakdown for Seedance

    Supreme-Ultimate/novel-to-script-team

    Breaks a script or outline into plot points and writes a director's walkthrough, character list and scene list sized for Seedance video generation.

    175 GitHub stars~1.3k tokensUpdated 5 mo ago
    Auto-check passed
  • Hit Script Retrieval Skill

    Supreme-Ultimate/novel-to-script-team

    爆款剧本检索技能。使用混合搜索(语义+关键词)检索最相关的爆款剧本,为生成提供参考. An agent skill from Supreme-Ultimate/novel-to-script-team.

    175 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Image Generation Skill

    Supreme-Ultimate/novel-to-script-team

    调用 nano banana API(gemini-3.1-flash-image-preview)生成图片。支持纯文本生图和参考图生图。

    175 GitHub stars~640 tokensUpdated 5 mo ago
    Auto-check: notes

Works with

Questions about Film Storyboard Prompt Builder

What does Film Storyboard Prompt Builder do?

Turns a script, synopsis or scene outline into AI image prompts for storyboards, using a beat breakdown, a nine-panel Beat Board and four-panel Sequence Boards. The skill converts screenplay material into prompts for AI image generation in three layers. It first writes a beat breakdown that marks nine narrative turning points, each with a purpose, an emotion and a time estimate.

When should I use Film Storyboard Prompt Builder?

Film Storyboard Prompt Builder fits situations like: turning a screenplay or synopsis into storyboard image prompts; planning nine key story beats before generating images; keeping characters and lighting consistent across storyboard panels; preparing prompts for an AI image tool from a scene outline.

How do I install Film Storyboard Prompt Builder in Claude Code?

Run `npx skills add Supreme-Ultimate/novel-to-script-team --skill film-storyboard-skill -a claude-code`. Or copy the skill folder (skills/film-storyboard-skill in Supreme-Ultimate/novel-to-script-team) into .claude/skills/film-storyboard-skill in your project. Claude Code loads it when a task matches its description.

How do I install Film Storyboard Prompt Builder in Codex?

Run `npx skills add Supreme-Ultimate/novel-to-script-team --skill film-storyboard-skill -a codex`. Or copy the skill folder (skills/film-storyboard-skill in Supreme-Ultimate/novel-to-script-team) into .agents/skills/film-storyboard-skill in your project. Codex loads it when a task matches its description.

Can I use Film Storyboard Prompt Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Supreme-Ultimate/novel-to-script-team --skill film-storyboard-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/film-storyboard-skill, .gemini/skills/film-storyboard-skill, .github/skills/film-storyboard-skill and .opencode/skills/film-storyboard-skill in your project.

What does Film Storyboard Prompt Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Film Storyboard Prompt Builder is instructions for the agent only. Our summary lists: The project's references folder with the storyboard methodology files.

Does Film Storyboard Prompt Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Film Storyboard Prompt Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Film Storyboard Prompt Builder use?

Film Storyboard Prompt Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Film Storyboard Prompt Builder use?

About 815 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Film Storyboard Prompt Builder?

Skills that share tags, products or a category with Film Storyboard Prompt Builder: Character Design with genmedia (fal-ai-community/skills, 251 stars), Professional Media Prompts (agentscope-ai/QwenPaw, 36k stars), Seedance Storyboard Generator (liangdabiao/Seedance2-Storyboard-Generator, 2.6k stars) and Seedance Storyboard in Shanghai Animation Style (liangdabiao/smy-seedance-storyboard, 138 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Film Storyboard Prompt Builder?

Supreme-Ultimate (a GitHub organization) maintains it in Supreme-Ultimate/novel-to-script-team, which has 175 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on May 2, 2026.

Source: Supreme-Ultimate/novel-to-script-team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.