Agent skill

Generate Storyboard

by ArcReel in ArcReel/ArcReel

为分镜生成分镜图。当用户说"生成分镜"、"预览分镜画面"、想重新生成某些分镜图、或剧本中有分镜缺少分镜图时使用。自动保持角色和画面连续性。

AGPL-3.0Auto-check passedMedia & Creative

Install Generate Storyboard

skills CLI
$ npx skills add ArcReel/ArcReel --skill generate-storyboard -a claude-code

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

GitHub CLI
$ gh skill install ArcReel/ArcReel generate-storyboard --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/ArcReel/ArcReel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent_runtime_profile/.claude/skills/generate-storyboard .claude/skills/generate-storyboard && 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
generate-storyboard
GitHub stars
5.4k
Token cost
~816 tokens
SKILL.md length
200 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
AGPL-3.0

At a glance

为分镜生成分镜图。当用户说"生成分镜"、"预览分镜画面"、想重新生成某些分镜图、或剧本中有分镜缺少分镜图时使用。自动保持角色和画面连续性。

  • Works in 4 steps: 加载项目和剧本 — 确认所有角色都有 character_sheet 图像 → 生成分镜图 — MCP 工具自动检测… → 审核检查点 — 展示每张分镜图,用户可批准、要求重新生成,或要求编辑 → …
  • Tasks that involve Comics and storyboards
  • SKILL.md covers 工具调用, 工作流程, 审核检查点:编辑 vs 重新生成 and 角色一致性机制, plus 3 more sections
  • Calls python

What it does

Generate Storyboard is an agent skill from ArcReel/ArcReel. 为分镜生成分镜图。当用户说"生成分镜"、"预览分镜画面"、想重新生成某些分镜图、或剧本中有分镜缺少分镜图时使用。自动保持角色和画面连续性。

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Comics and storyboards and AI video generation. It works with Model Context Protocol. The repository describes itself as: AI Agent 驱动的开源可自部署视频工作台:将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿,支持跨镜头一致性、多供应商与费用追踪 | Self-hosted AI video workspace for stories, storyboards and short-form video production. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Comics and storyboards
  • Tasks that involve AI video generation

Example prompts

  • “预览分镜画面”
  • “/generate-storyboard”

Requirements

  • Python 3

Workflow steps

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

  1. 加载项目和剧本 — 确认所有角色都有 character_sheet 图像
  2. 生成分镜图 — MCP 工具自动检测 content_mode,按相邻关系串联依赖任务
  3. 审核检查点 — 展示每张分镜图,用户可批准、要求重新生成,或要求编辑
  4. 更新剧本 — 更新 storyboard_image 路径和场景状态

What it can do on your machine

Read from SKILL.md and the folder at commit 2dd9d91. 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

    Shell commands in SKILL.md call:

    • python

    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

Generate Storyboard loads about 816 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 200 words of instructions outside code blocks.

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

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 ArcReel/ArcReel at commit 2dd9d91, republished under its AGPL-3.0 licence (© ArcReel). 200 words, ~816 tokens.

Download SKILL.mdSave it as .claude/skills/generate-storyboard/SKILL.md (or your agent's skills folder).
name
generate-storyboard
description
为分镜生成分镜图。当用户说"生成分镜"、"预览分镜画面"、想重新生成某些分镜图、或剧本中有分镜缺少分镜图时使用。自动保持角色和画面连续性。

生成分镜图

通过生成队列创建分镜图,画面比例根据 content_mode 自动设置。

生成模式规格详见 .claude/references/generation-modes.md。

工具调用

重要:生成分镜图必须调用下列 MCP 工具入队。此 skill 不提供任何 Python/Shell 脚本,不得用 BASH 调 python .../scripts/*.py。

通过 MCP 工具入队:

操作工具
提交所有缺失分镜图mcp__arcreel__generate_storyboards({"script": "episode_1.json"})
重新生成指定 IDmcp__arcreel__generate_storyboards({"script": "episode_1.json", "segment_ids": ["E1S05"]})
重新生成多个 IDmcp__arcreel__generate_storyboards({"script": "episode_1.json", "segment_ids": ["E1S01", "E1S02"]})

选择规则:segment_ids 兼容 narration 的 segment_id 与 drama 的 scene_id;未传则提交所有缺失项。

依赖:generation worker 必须在线(图像/视频两条独立通道),worker 负责实际生成与速率控制。

工作流程

  1. 加载项目和剧本 — 确认所有角色都有 character_sheet 图像
  2. 生成分镜图 — MCP 工具自动检测 content_mode,按相邻关系串联依赖任务
  3. 审核检查点 — 展示每张分镜图,用户可批准、要求重新生成,或要求编辑
  4. 更新剧本 — 更新 storyboard_image 路径和场景状态

审核检查点:编辑 vs 重新生成

  • 只想改局部(如某个分镜的手部畸形、背景杂物、光线偏差),且构图/角色一致性满意 → 用 mcp__arcreel__edit_images({"resource_type": "storyboard", "script_file": "episode_1.json", "edits": [{"id": "E1S05", "instruction": "去掉背景里多余的路人"}]}) 保底图微调,不影响 image_prompt,一次可批量下发多个分镜
  • 想推翻构图或角色/参考图关系,或 image_prompt 本身要改 → 用 patch_episode_script 改 image_prompt 后,紧接着调 generate_storyboards 重新生成
  • 编辑不会更新 image_prompt——编辑后再触发 generate_storyboards 仍按原 image_prompt 重画,编辑效果只能从版本历史找回

角色一致性机制

MCP 工具自动处理以下参考图传入,无需手动指定:

  • character_sheet:场景中出场角色的资产图,保持外貌一致
  • scene_sheet / prop_sheet:场景中出现的场景 / 道具资产图
  • 商品参考(广告/短片项目):分镜 products_in_shot 非空时自动注入商品参考并排在所有参考之前(有 product sheet 时 sheet + 原图,无 sheet 时原图直注);声明行把这些序位标为商品参考图并要求画面中的商品与之完全一致——image_prompt 无需复述商品外观
  • 上一张分镜图:相邻片段默认引用,排在参考图列表最后,只参考构图与色调
  • 当片段标记 segment_break=true 时,跳过上一张分镜图参考

参考图对模型只是一个按顺序排列的图数组,prompt 用「图N」指认它们(N = 参考图在数组中的位置,商品在前, 然后是角色 / 场景 / 道具资产图,上一张分镜图最后):

  • 生成端在 Style 与 Scene 之间插一行 Reference_Images 类型声明,例如 图1、图2为角色参考图;图3为场景参考图;图4为上一分镜图,只参考构图与色调。;商品分镜为 图1为商品参考图,画面中的商品须与之完全一致;……
  • image_prompt.scene 里用 @[登记名] 指认资产(衍生形态写 @[角色/衍生]),生成端按上述编号把它换成对应的「图N」; 该名字须同时写进条目的引用字段(characters_in_* / scenes / props / products_in_shot),参考图只由引用字段决定,@[] 不会额外带图
  • 未登记或不在引用字段里的 @[名称] 按名字原样发送;generate_episode_script / patch_episode_script 的回执 warnings 会列出这类引用,按提示补登记或补引用字段后重新生成

Prompt 模板

生成端按项目 style、参考图列表与条目 image_prompt 渲染最终 prompt(get_prompt_preview 可查看逐字文本):

Style: [项目 style]
Reference_Images: 图1、图2为角色参考图;图3为场景参考图;图4为上一分镜图,只参考构图与色调。
Scene: [image_prompt.scene,其中 @[登记名] 已换成对应的图N]
Composition:
  shot_type: [image_prompt.composition.shot_type]
  lighting: [image_prompt.composition.lighting]
  ambiance: [image_prompt.composition.ambiance]
Avoid: 水印、多余文字、Logo

画面比例通过 API 参数设置,不写入 prompt。

生成前检查

  • 所有角色都有已批准的 character_sheet 图像
  • 场景视觉描述完整
  • 角色动作已指定

错误处理

结果结构与逐 ID 问题码见 .claude/references/generation-results.md。

  • 单场景失败不影响批次,工具返回 requested / succeeded / failed / blocked 的逐 ID 结果
  • 按每一项自带的 problem.code 与 problem.action 决定重试还是先改输入,不要读文本猜
  • 不传 segment_ids 即只补缺;已失效但可用的旧分镜图会被复用,不自动重生
  • 可重试的场景用 mcp__arcreel__generate_storyboards({"script": "...", "segment_ids": [...]}) 点名重做

© ArcReel, AGPL-3.0. 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 agent_runtime_profile/.claude/skills/generate-storyboard of ArcReel/ArcReel.

Open the folder on GitHubat commit 2dd9d91

Compare with similar skills

Generate Storyboard 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.

Generate Storyboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Generate Storyboard this skillArcReel/ArcReel5.4k—~816Automated safety check: PassAGPL-3.0
Storyboard Cheatcodealecs5am/ralphy138—~2kAutomated safety check: PassMIT
Music Videoguaardvark/guaardvark257—~774Automated safety check: PassMIT
Seedance2 APIaiskillstore/marketplace433—~3.7kAutomated safety check: PassMIT
Scroll Promo Site Builderkangarooking/kangarooking-skills662—~2.6kAutomated safety check: PassMIT
Music VideoNoizAI/skills526—~1.5kAutomated safety check: PassNone

Similar skills

  • Storyboard Cheatcode

    alecs5am/ralphy

    Turn a one-line concept into a multi-panel previs storyboard image, then optionally a cheap-preview video and a hero video render.

    138 GitHub stars~2k tokensUpdated 18 days ago
    Media & CreativeAuto-check passed
  • Music Video

    guaardvark/guaardvark

    Turn a song into a beat-synced music video with Guaardvark's Director: song analysis, per-cut shot prompts, storyboard keyframes, image-to-video renders, cuts on the beat.

    257 GitHub stars~774 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Seedance2 API

    aiskillstore/marketplace

    Out-of-the-box Seedance 2.0 API skill — just one API key to generate AI videos.

    433 GitHub stars~3.7k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Scroll Promo Site Builder

    kangarooking/kangarooking-skills

    Create a scroll-controlled cinematic product website with rich motion (动效网站) from product materials, reference pages or videos, and brand assets.

    662 GitHub stars~2.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Music Video

    NoizAI/skills

    Build a music video from an existing song and lyrics, either as p5.js/p5.brush animation or by assembling local images and clips.

    526 GitHub stars~1.5k tokensUpdated 13 days ago
    Media & CreativeAuto-check passed
  • Video Compose

    Utopai-Research/pai-code

    Generates and prompts video clips on the filmmaking canvas. An agent skill from Utopai-Research/pai-code.

    357 GitHub stars~4.1k tokensUpdated 11 days ago
    Media & CreativeAuto-check passed

More from ArcReel/ArcReel

All 18 skills in this repo
  • PR AI Review Loop

    ArcReel/ArcReel

    PR AI review 收敛。用户或 team-lead 要求启动或继续审查—修复循环时使用;供本地实现者或受委派的 review-looper 调用,不用于 GitHub reviewer 产出审查意见或仅处理单条评论。

    5.4k GitHub stars~667 tokensUpdated yesterday
    Auto-check passed
  • Tech Doc Style Chinese

    ArcReel/ArcReel

    在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

    5.4k GitHub starsUsed in 1 repo~845 tokens
    Auto-check passed
  • Translate Docs

    ArcReel/ArcReel

    Translate every dirty ArcReel documentation source into English and refresh the translation lockfile.

    5.4k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Adapt Custom Endpoint

    ArcReel/ArcReel

    当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

    5.4k GitHub stars~413 tokensUpdated yesterday
    Auto-check passed
  • Afk Team Workflow

    ArcReel/ArcReel

    把一个 Spec 的全部子 issue(或一组显式 issue)组建团队无人值守跑到全部合并或明确暂停. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~794 tokensUpdated yesterday
    Auto-check passed
  • Update Docs

    ArcReel/ArcReel

    根据最近的 git 改动,更新面向用户的文档(README 双语、入门教程、部署、剪映导出等)。手动调用. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~544 tokensUpdated yesterday
    Auto-check: notes

Questions about Generate Storyboard

What does Generate Storyboard do?

为分镜生成分镜图。当用户说"生成分镜"、"预览分镜画面"、想重新生成某些分镜图、或剧本中有分镜缺少分镜图时使用。自动保持角色和画面连续性。. Generate Storyboard is an agent skill from ArcReel/ArcReel.

When should I use Generate Storyboard?

Generate Storyboard fits situations like: tasks that involve Comics and storyboards; tasks that involve AI video generation.

How do I install Generate Storyboard in Claude Code?

Run `npx skills add ArcReel/ArcReel --skill generate-storyboard -a claude-code`. Or copy the skill folder (agent_runtime_profile/.claude/skills/generate-storyboard in ArcReel/ArcReel) into .claude/skills/generate-storyboard in your project. Claude Code loads it when a task matches its description.

How do I install Generate Storyboard in Codex?

Run `npx skills add ArcReel/ArcReel --skill generate-storyboard -a codex`. Or copy the skill folder (agent_runtime_profile/.claude/skills/generate-storyboard in ArcReel/ArcReel) into .agents/skills/generate-storyboard in your project. Codex loads it when a task matches its description.

Can I use Generate Storyboard 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 ArcReel/ArcReel --skill generate-storyboard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/generate-storyboard, .gemini/skills/generate-storyboard, .github/skills/generate-storyboard and .opencode/skills/generate-storyboard in your project.

What does Generate Storyboard need to run?

Going by SKILL.md and its folder, Generate Storyboard needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Generate Storyboard 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 Generate Storyboard 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 Generate Storyboard use?

Generate Storyboard is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Generate Storyboard use?

About 816 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 Generate Storyboard?

Skills that share tags, products or a category with Generate Storyboard: Storyboard Cheatcode (alecs5am/ralphy, 138 stars), Music Video (guaardvark/guaardvark, 257 stars), Seedance2 API (aiskillstore/marketplace, 433 stars) and Scroll Promo Site Builder (kangarooking/kangarooking-skills, 662 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Generate Storyboard?

ArcReel (a GitHub organization) maintains it in ArcReel/ArcReel, which has 5,426 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 10, 2026.

Source: ArcReel/ArcReel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.