Agent skill

Storyboard Breakdown Rules

by chatfire-AI in chatfire-AI/huobao-drama

Rules for splitting a script into storyboard segments of several sub-shots each, with timing, shot elements, and links to scenes, characters and props.

Custom licenceAuto-check passedMedia & Creative

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

Install Storyboard Breakdown Rules

skills CLI
$ npx skills add chatfire-AI/huobao-drama --skill storyboard-breaker -a claude-code

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

GitHub CLI
$ gh skill install chatfire-AI/huobao-drama storyboard-breaker --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/chatfire-AI/huobao-drama.git skills-src && mkdir -p .claude/skills && cp -r skills-src/backend/workspace/skills/storyboard-breaker .claude/skills/storyboard-breaker && 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
storyboard-breaker
GitHub stars
16k
Token cost
~575 tokens
SKILL.md length
160 words
Files
4
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Rules for splitting a script into storyboard segments of several sub-shots each, with timing, shot elements, and links to scenes, characters and props.

  • Works in 4 steps: 调用 read_storyboard_context… → 节拍识别:先识别剧本的叙事节拍——剧本中的【开场】【触发】【高潮】【收尾】等标记,… → 总量锚定:目标总时长 = 剧本字数 ÷ 500字/分钟;段落数 ≈ 目标总时长… → …
  • Breaking a short-drama script into video-generation segments
  • SKILL.md covers 核心定义:分镜段落, 拆分流程(四步), 节奏分层时长 and 台词时长下限(硬规则), plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

In this spec one storyboard is one segment and one video-generation task. A segment runs 8 to 15 seconds and holds 2 to 4 sub-shots of 2 to 6 seconds each; sub-shots may cut between shot sizes, angles and subjects, but a segment never crosses scenes. The process has four steps: read the storyboard context (script, characters, scenes, props, existing summaries), identify story beats and force a split at beat boundaries while keeping each cause-and-effect chain together, anchor the total length, then split into sub-shots and save everything in one call.

Length is anchored by dividing script characters by 500 per minute and aiming for about one segment per 12 seconds, give or take 20 percent, with transitions at 8 to 10 seconds, narrative segments at 10 to 15 and peak moments at 12 to 15. A hard floor says segment time must cover spoken lines and narration at 4.5 characters per second plus a 2-second margin, and lines that do not fit move to the next segment.

Each segment carries a title, time and light, location, shot size, angle, camera movement, a numbered shot-by-shot description with dialogue inline, result, atmosphere, duration and links to existing scene, character and prop IDs, which must come from the context and never be invented. Prop links supply reference images for consistent appearance. The skill text is in Chinese, with English, Japanese and Korean versions alongside.

When your agent uses it

  • Breaking a short-drama script into video-generation segments
  • Fitting dialogue into segment durations
  • Binding scenes, characters and props to each storyboard segment
  • Revising individual storyboard segments after review

Example prompts

  • “Split episode three of the script into storyboard segments and save them.”
  • “Check that each segment is long enough for its dialogue and move any lines that do not fit.”
  • “Bind the right character and prop IDs to the courtyard scene segments.”

Requirements

  • Storyboard tools: read_storyboard_context, save_storyboards and update_storyboard

Workflow steps

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

  1. 调用 read_storyboard_context 读取剧本、角色、场景、道具、已有分镜摘要
  2. 节拍识别:先识别剧本的叙事节拍——剧本中的【开场】【触发】【高潮】【收尾】等标记,或叙事转折点(地点转移、规则揭示、情绪爆发、反转)。节拍边界强制切段,同一节拍内的子镜头优先归入同一段落,不把一条因果链(铺垫-发生-反应)切散到不同段落
  3. 总量锚定:目标总时长 = 剧本字数 ÷ 500字/分钟;段落数 ≈ 目标总时长 ÷ 12秒,允许 ±20% 浮动。不要明显超出或不足
  4. 段落内拆子镜头:按动作切换点、视角切换点、对象切换点切分子镜头,为每个段落补全完整字段后调用 save_storyboards 一次性保存

What it can do on your machine

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

    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

Storyboard Breakdown Rules loads about 575 tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 160 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 160 words (~575 tokens).

name
storyboard-breaker

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in backend/workspace/skills/storyboard-breaker of chatfire-AI/huobao-drama.

  • SKILL.md
  • SKILL.en.md
  • SKILL.ja.md
  • SKILL.ko.md

Open the folder on GitHubat commit 26de7df

Compare with similar skills

Storyboard Breakdown Rules 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.

Storyboard Breakdown Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Storyboard Breakdown Rules this skillchatfire-AI/huobao-drama16k—~575Automated safety check: PassCustom licence
Seedance Storyboard in Shanghai Animation Styleliangdabiao/smy-seedance-storyboard138—~3kAutomated safety check: PassNone
MiniMax H3 Video DirectorTFboy1/oh-my-minimaxh3-director143—~2.4kAutomated safety check: PassMIT
Seedance 2.0 Storyboard Promptselementsix/elementsix-skills311—~1.4kAutomated safety check: PassMIT
Painterly 3D2 Cinema Promptsliucongg/liucong-skills248—~1.8kAutomated safety check: PassApache-2.0
AI Visual Directorjijiutong/ai-visual-director176—~1kAutomated safety check: PassMIT

Similar skills

  • 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
  • MiniMax H3 Video Director

    TFboy1/oh-my-minimaxh3-director

    Turns a script into a storyboard, assigns MiniMax H3 workflows in ComfyUI, monitors batch generation and builds a Jianying draft of the finished video.

    143 GitHub stars~2.4k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Seedance 2.0 Storyboard Prompts

    elementsix/elementsix-skills

    Interviews you about a video idea, then writes a timed shot-by-shot prompt for Seedance 2.0 using its image, video and audio reference syntax.

    311 GitHub stars~1.4k tokensUpdated 7 mo ago
    Media & CreativeAuto-check passed
  • Painterly 3D2 Cinema Prompts

    liucongg/liucong-skills

    Expands one sentence into a prompt package for painterly 3D-to-2D short films: story, 15-second segments, characters, scenes, Midjourney storyboards and Seedance video prompts.

    248 GitHub stars~1.8k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • AI Visual Director

    jijiutong/ai-visual-director

    Routes story-to-video work through slash commands for character cards, scene images, storyboards, video prompts and posters, with prompt QC and draft, lock and commit states.

    176 GitHub stars~1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Video Plan

    MagicCube/agentara

    Plan short-form video, vlog, travel, lifestyle, documentary, or cinematic social video scripts by negotiating duration, choosing a story arc and visual style, then splitting the film into timed…

    516 GitHub starsUsed in 1 repo~2.6k tokens
    Media & CreativeAuto-check passed

More from chatfire-AI/huobao-drama

  • Character Reference Sheet Prompt

    chatfire-AI/huobao-drama

    Writes the final image prompt for a character reference sheet: a front-face close-up beside front, side and back full-body views, used as the look anchor for later generations.

    16k GitHub stars~329 tokensUpdated 5 days ago
    Auto-check passed
  • Prop Product-Shot Prompt Spec

    chatfire-AI/huobao-drama

    Specifies how to write the final image prompt for a story prop: one item on a pure white background in a standard product-photo view, with true proportions.

    16k GitHub stars~262 tokensUpdated 5 days ago
    Auto-check passed
  • Scene Establishing-Shot Prompt

    chatfire-AI/huobao-drama

    Writes the final image prompt for a clear wide establishing shot of an empty scene, fixing foreground, midground, background, exits, floor, walls and key furnishings.

    16k GitHub stars~378 tokensUpdated 5 days ago
    Auto-check passed
  • Storyboard Video Prompt Writer

    chatfire-AI/huobao-drama

    Turns one storyboard segment into a time-segmented video-generation prompt with character and scene references, three-second beats and cuts inside the segment.

    16k GitHub stars~487 tokensUpdated 5 days ago
    Auto-check passed
  • Novel to Screenplay Rewriter

    chatfire-AI/huobao-drama

    Rewrites narrated novel chapters into a formatted screenplay with scene headers and dialogue, keeping the plot and cutting camera directions.

    16k GitHub stars~209 tokensUpdated 5 days ago
    Auto-check passed
  • Drama Script Entity Extractor

    chatfire-AI/huobao-drama

    Rules for pulling characters, scenes and key props out of a short-drama episode script and saving them without duplicates, written in Chinese.

    16k GitHub stars~491 tokensUpdated 5 days ago
    Auto-check passed

Questions about Storyboard Breakdown Rules

What does Storyboard Breakdown Rules do?

Rules for splitting a script into storyboard segments of several sub-shots each, with timing, shot elements, and links to scenes, characters and props. In this spec one storyboard is one segment and one video-generation task. A segment runs 8 to 15 seconds and holds 2 to 4 sub-shots of 2 to 6 seconds each; sub-shots may cut between shot sizes, angles and subjects, but a segment never crosses scenes.

When should I use Storyboard Breakdown Rules?

Storyboard Breakdown Rules fits situations like: breaking a short-drama script into video-generation segments; fitting dialogue into segment durations; binding scenes, characters and props to each storyboard segment; revising individual storyboard segments after review.

How do I install Storyboard Breakdown Rules in Claude Code?

Run `npx skills add chatfire-AI/huobao-drama --skill storyboard-breaker -a claude-code`. Or copy the skill folder (backend/workspace/skills/storyboard-breaker in chatfire-AI/huobao-drama) into .claude/skills/storyboard-breaker in your project. Claude Code loads it when a task matches its description.

How do I install Storyboard Breakdown Rules in Codex?

Run `npx skills add chatfire-AI/huobao-drama --skill storyboard-breaker -a codex`. Or copy the skill folder (backend/workspace/skills/storyboard-breaker in chatfire-AI/huobao-drama) into .agents/skills/storyboard-breaker in your project. Codex loads it when a task matches its description.

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

What does Storyboard Breakdown Rules need to run?

SKILL.md names no scripts, command-line tools or credentials: Storyboard Breakdown Rules is instructions for the agent only. Our summary lists: Storyboard tools: read_storyboard_context, save_storyboards and update_storyboard.

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

Storyboard Breakdown Rules has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Storyboard Breakdown Rules use?

About 575 tokens (SKILL.md is roughly 2.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 Storyboard Breakdown Rules?

Skills that share tags, products or a category with Storyboard Breakdown Rules: Seedance Storyboard in Shanghai Animation Style (liangdabiao/smy-seedance-storyboard, 138 stars), MiniMax H3 Video Director (TFboy1/oh-my-minimaxh3-director, 143 stars), Seedance 2.0 Storyboard Prompts (elementsix/elementsix-skills, 311 stars) and Painterly 3D2 Cinema Prompts (liucongg/liucong-skills, 248 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Storyboard Breakdown Rules?

chatfire-AI (a GitHub organization) maintains it in chatfire-AI/huobao-drama, which has 15,945 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 5, 2026.

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