video-agent-storyboarder

video-agent-storyboarder is a skill for Claude Code, Codex from chenyuxiaojin/video-agent-skills. It costs 116 tokens per session (1,825 once invoked), scanned A, original, MIT.

A video storyboarding workflow that turns a script into a shot-by-shot plan describing what should appear on screen for each line.

In plain words
What is it for?
Use it with a script.md file to generate storyboard.json and storyboard.md, including shot timing, visual descriptions, mood, media type, and target video length.
Why use it?
It saves the video team from planning every shot manually and creates both structured data and a readable document for review.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it with a script.md file to generate storyboard.json and storyboard.md, including shot timing, visual descriptions, mood, media type, and target video length.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add chenyuxiaojin/video-agent-skills --skill video-agent-storyboarder
Clone the repo
git clone --depth 1 https://github.com/chenyuxiaojin/video-agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for video-agent-storyboarder

README.md
[![agentmods](https://agentmods.dev/badge/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder/github.svg)](https://agentmods.dev/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder)
Your own site
<a href="https://agentmods.dev/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder"><img src="https://agentmods.dev/badge/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for video-agent-storyboarder

Your own site · 80×15
<a href="https://agentmods.dev/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder"><img src="https://agentmods.dev/badge/skills/chenyuxiaojin/video-agent-skills/video-agent-storyboarder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 116 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,825 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00116 $0.01825
Opus 5 $0.00058 $0.00912
Sonnet 5 $0.00023 $0.00365
Haiku 4.5 $0.00012 $0.00183

Measured 12d ago against content hash 5ba99bd0104d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

video-agent-storyboarder scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/generate_storyboard.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- 标准库:json, pathlib, argparse, urllib
video-agent-storyboarder/SKILL.md · 183 lines

How it starts

The opening of the file, as written. The whole thing — 183 lines — stays where its author put it; the contents beside it link to each section on GitHub.

video-agent-storyboarder(分镜师)

职责边界

分镜师是文字世界和画面世界的桥梁。通过 Gemini Flash API 自动生成分镜:

  • ✅ 调用 generate_storyboard.py 脚本自动拆稿和设计画面
  • ✅ 审核生成的分镜质量(格式、覆盖度、节奏)
  • ✅ 必要时手动调整个别镜头
  • ❌ 写逐字稿(编剧负责)
  • ❌ 搜索下载素材文件(美术负责)
  • ❌ 构建时间轴(剪辑师负责)

输入 → 输出

  • 输入:script.md(编剧产出的逐字稿)
  • 输出:storyboard.json(结构化数据)+ storyboard.md(可读版本)

执行方式

运行脚本

python scripts/generate_storyboard.py <project_dir> [--style <风格>] [--duration <时长>]

参数:

  • project_dir — 项目目录(包含 script.md)
  • --style — 视频风格描述(默认:"AI科技/知识分享")
  • --duration — 目标时长(默认:"6-10分钟")

脚本会:

  1. 读取 script.md
  2. 用 prompt 模板 + 变量替换构建 prompt
  3. 调用 Gemini Flash API(gemini-2.5-flash,低成本纯文本模型)
  4. 解析 JSON 响应
  5. 输出 storyboard.json + storyboard.md
  6. 失败自动重试 1 次

storyboard.json 格式

[
  {
    "shot_number": 1,
    "time_range": "0:00-0:05",
    "script_text": "你有没有想过一个问题",
    "asset_type": "概念画面",
    "media_format": "ai_video",
    "visual_description": "A person scrolling through a phone with countless notification pop-ups flooding the screen, warm office lighting, close-up shot, dynamic movement",
    "mood": "焦虑、快切",
    "duration_seconds": 5
  }
]

storyboard.md 格式

# 分镜表 — 视频标题

> 总镜头数:XX 个

---

| 镜头 | 时间 | 秒 | 对应逐字稿 | 素材类型 | 媒体格式 | 画面说明 | 情绪 |
|------|------|----|-----------|---------|---------|---------|------|
| 001 | 0:00-0:05 | 5 | 你有没有想过一个问题 | 概念画面 | ai_video | A person scrolling... | 焦虑、快切 |

核心规则

素材类型(asset_type)

类型 说明 典型 media_format
截图 真实产品/网页/App 界面截图或录屏 manual
真实人物 提到的真实公众人物照片 manual
文字卡 关键概念、金句、结论的排版动效 post_production
数据图表 统计数字、趋势图、对比图 post_production
概念画面 抽象隐喻、无法实拍的概念可视化 ai_video / ai_image
引用片段 新闻报道、产品演示、公开视频截取 manual
信息图 逻辑关系图、流程图、对比表 post_production
留白 纯色/渐变背景,让声音主导 simple
书籍 提到的书籍/论文封面 ai_image / manual
分屏 多画面同时展示 post_production

媒体格式(media_format)

格式 说明
ai_video AI 生成 5-10 秒动态视频(Veo 3/Seedance/Kling/Sora)
ai_image AI 生成静态图片
manual 需人工准备(截图、搜索真实照片、录屏)
post_production 后期制作(文字动效、数据图表、信息图)
simple 简单背景,无需制作

Read the full file on GitHub · 183 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 183 lines · 116 tokens per session scan A 5ba99bd0104d

Subscribe to this mod's changes

video-agent-storyboarder is a skill published in the GitHub repository chenyuxiaojin/video-agent-skills (9 stars, last pushed 3mo ago), licensed MIT. It adds 116 tokens to every session and 1,825 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

suggest-sfx

The SFX pass. Analyze a short's beats + narration and propose tasteful sound effects synced to them, drawing from (and growing) a shared, reusable SFX library, then render an SFX-mixed audition preview. Use when the user wants to "add SFX / sound effects", "suggest sfx", "score the transitions", "sound-design this…

hassancs91/claude-faceless-shorts-creator · 169 tokens

make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, 35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to…

hassancs91/claude-faceless-shorts-creator · 180 tokens

make-short

Build a fully-synthetic vertical short (1080×1920, 40s) end-to-end from a topic — script + beats.json, linked TSX beats over a persistent canvas, phone-scale QA, render, ElevenLabs voice with exact word-synced captions, SFX audition, optional music bed. Use when the user wants to "make a short", "create a shorts…

hassancs91/claude-faceless-shorts-creator · 183 tokens

make-vox

Build a Vox-style LAYERED-COLLAGE vertical short end-to-end — script + scene dissection into image layers, layer production (AI images via genimage.py + cutout.py, HTML→PNG, SVG-in-TSX), choreographed TSX assembly on the collage kit (CollageBoard camera, parallax, cutouts, chips, routes), frame QA, render, then…

hassancs91/claude-faceless-shorts-creator · 182 tokens

talking-head-edit

Edit interviews, lessons, commentary, podcasts, and direct-to-camera recordings built around speech. Use it to remove dead air, filler words, false starts, repeated lines, and discarded retakes while preserving natural delivery and keeping captions aligned. When the user asks for visual enhancement, also use it for…

pireel/pireel · 79 tokens

montage-edit

Discover the governing emotion and visual motifs in a body of footage, then compose a montage whose image, rhythm, sound, and text form one intentional experience.

pireel/pireel · 35 tokens