Storyboard · Biblioteca de Julgamento de Sequências de Câmera
Penny777btc/storyboard
Transforma scripts em sequências de planos estruturadas com ritmo e continuidade
Ver no GitHubSkill do Claude que transforma scripts de narração em sequências de planos estruturadas (enquadramentos, ângulos, transições, ritmo). Baseado em princípios de design de storyboard cinematográfico, ajuda a definir antes de gravar: quantos planos usar, qual enquadramento para cada um, de qual ângulo filmar e como conectar os planos de forma fluida.
Instalação
npx convez-ai Penny777btc/storyboard1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Planejamento de vídeos e screencasts antes da gravação
- Estruturação de sequências de planos por enquadramentos e ângulos
- Validação de continuidade visual e transições entre planos
- Diagnóstico de problemas de fluidez em edições (cortes inadequados, saltos de eixo)
- Criação de checklist de verificação de storyboard para equipes de produção
Veredito

Ferramenta sólida e especializada para produção de vídeo, com metodologia clara baseada em referências acadêmicas. Preenche um gap real entre script e execução, mas exige compreensão de conceitos cinematográficos para aproveitar ao máximo; ideal para produtores e editores que querem padronizar decisões visuais.
README
A tradução para o português deste README ainda está na fila.
storyboard · 分镜(镜头序列)设计判断库
一个给 视频剪辑 / 拍摄 / 录屏 用的 Claude 技能(skill):把一段口播脚本/创意,拆成「一镜一镜」的镜头序列——景别、机位、切换、节奏、镜头清单,并给出「这段为什么接得不顺」的可执行判断。 来源:[意] 乔瑟·克里斯提亚诺《分镜头脚本设计教程》(Storyboarding Design Course)。
配套:画面里「看什么」交给 shot-language(画面构图),机位走位交给同系列 camera-blocking。本 skill 只管「镜头怎么排序、怎么接」。
这是什么
它不是一个"剪辑工具",而是一套分镜判断标准。
写完脚本要开拍 / 录屏时,你大概率遇到过这种情况:"这段话到底用几个镜头?每个镜头拍多大、从哪个角度?两镜之间怎么接才不别扭?" 这个 skill 就是把这些"凭感觉"的决定,变成一条条能复述、能检查的规则——让你(和 AI)用同一套标准去判断:
- 这一段话该拆几个镜头?每镜是什么景别(全景 / 中景 / 特写)?
- 从什么机位角度拍才对(平视 / 微仰 / 微俯)?角度暗示的是什么心理?
- 两个镜头之间用什么切换接得最顺?哪里跳轴 / 跳接 / 切太碎了?
核心一句话:
分镜 = 成片的预演。在动笔拍 / 录之前,把"这段话用几个镜头、每镜什么景别+机位、怎么接"先定下来,让镜头到镜头的流动顺畅(连贯性)。
它在视频里帮你做什么
| 制作环节 | 这个 skill 给你的判断 |
|---|---|
| 写完脚本 → 分镜 | 把口播脚本/创意拆成镜头清单:摘关键帧、定每镜景别+机位+动作、标切换方式(「分镜五步」) |
| 拍摄 / 录屏前 | 拿着镜头清单当施工图:这镜拍多大、从哪个角度、要不要运镜,开拍前都定好 |
| 选片 / 定景别 | 按已定的分镜序列选 take:这条是不是该景别、机位对不对、能不能接上一镜 |
| 粗剪排序 | 镜头顺序=分镜顺序;检查连贯性(屏幕方向 / 运动线)、切换太多 / 太少、跳轴 |
| 成片质检 | 跑「八条分镜检验」清单,把"接得不顺"定位成可改的项 |
怎么用
方式一:作为 Claude Code 技能(推荐)
把这个仓库放进你项目(或全局)的 skills 目录:
# 项目级
git clone https://github.com/Penny777btc/storyboard .claude/skills/storyboard
# 或全局级
git clone https://github.com/Penny777btc/storyboard ~/.claude/skills/storyboard
之后 Claude 会在你做"把脚本拆分镜 / 定景别机位 / 镜头怎么接 / 粗剪排序 / 这段为什么接不顺"这类任务时自动参考它;你也可以直接说:
"用 storyboard 把这段口播拆成镜头清单"
SKILL.md是操作层(何时用、怎么拆、怎么验收)——日常调用读这层。reference.md是原理层(书中第 5、6 单元提炼,每条都带"在本管线里怎么落地")——想知道"为什么"时翻这层。
方式二:当成一份"分镜速查清单"来读
不用 AI 也行。SKILL.md 里的「景别 / 机位 / 切换速查」和末尾的八条分镜检验可以直接拿去给自己的脚本和成片做体检;下面的核心法则 before/after 也能当速查卡。
核心法则 · 每条都是一组 before / after
这个 skill 的每一条原理,本身就是一个"常见毛病 → 修法"的 before/after。下面这 6 张「分镜稿纸」对比图,把最常用、最容易立竿见影的 6 条画成了一排分镜画框——左边使用前、右边使用后,一眼看懂:
![]() | ![]() |
![]() | ![]() |
![]() | ![]() |
01 景别序列:一排都是 WS → WS→MS→CU 渐进=叙事 | 02 建制镜头:开场就特写 → 先建制环境再切进 | 03 镜头节奏:每格等宽(闷)→ 长短错落=有快慢 | 04 动接动:切在动作前后(顿挫)→ 切在动作进行中(顺滑)| 05 朝向统一:相邻格朝向乱跳 → 朝向一致·守轴线 | 06 拆镜:一镜到底没层次 → 拆成主镜+近景序列。
下面把这些法则连同其余几条,逐条写清"使用前 / 使用后":
01 · 先摘关键帧,别逐句配镜
- 使用前:拿着脚本一句一句配画面,镜头碎、重点不突出,自己都说不清这段在讲什么。
- 使用后:先通读抓整体,再从文字里摘出"最值得动笔的画面"(动作发生点、重点/产品出现点);一段通常 5 个关键帧 + 1 个收尾特写就够。
02 · 定场镜头开头
- 使用前:上来直接怼特写 / 操作区,观众不知道"这是什么场景、元素怎么布局",看得懵。
- 使用后:一段开头先给定场 / 主镜头(全屏概览)交代地点时间,再 punch-in 推到特写——"交待镜头 → 特写"的最小序列。
03 · 用景别变换造节奏
- 使用前:全程一个景别(比如从头到尾中景),画面平、闷、推不动。
- 使用后:远→近推进(全景→中景→特写)=聚焦收紧,近→远=释放收尾;每个意义单元至少一次景别变换,节奏就出来了。
04 · 角度 = 心理印象
- 使用前:所有镜头都平视,或者随手用了俯仰,情绪和内容对不上。
- 使用后:按想给的心理印象选——亲和对等用平视,要显专业权威用微仰(人物登场),讲全局 / 示弱用微俯;极端角度要"有目的"。
05 · 关联剪辑接得不露痕迹
- 使用前:两镜硬切,时空跳跃明显,观众出戏。
- 使用后:用两镜里相同 / 相似的元素接(A 镜的圆形→B 镜的圆形),这是最顺的接法;日常以直切 + 关联剪辑为主,最干净。
06 · 守住屏幕方向与轴线
- 使用前:上一镜人物 / 动作朝右,下一镜突然朝左;对话两人"看向相反方向"——跳轴,观众瞬间懵。
- 使用后:守 180° 运动线,机位只在轴线一侧;动作衔接画箭头标方向,让 A 镜的动作"接得上"B 镜(伸手开门→门开了)。
07 · 该用淡入淡出才用
- 使用前:同场景里到处淡入淡出,拖沓、多余。
- 使用后:淡入淡出只留给场景 / 时间大跨度(黑夜→白天、内→外);流程 / 成长段用蒙太奇压缩时间;日常直切就够。
08 · 删掉多余的镜头
- 使用前:切换太多,画面碎、抓不住重点;或切换太少,信息推不动、节奏闷。
- 使用后:该合的合(两三镜并一镜)、该补的补(两镜间加画面);把粗剪当"分镜预览"过一遍,让序列更"聪明"而不是更精细。
它不做什么(边界)
- 不管画面里"看什么":单帧构图、主次、视线引导,交给 shot-language。本 skill 只管"排几个镜头、怎么排序接续"。
- 不管机位走位:人物 / 摄像机在空间里怎么站、怎么走,交给同系列 camera-blocking。
- 不替代具体执行:怎么 ffmpeg 运镜、怎么 Remotion 做关键帧动画,归剪辑工具。它只管"该不该、往哪、为什么"。
- 不是硬规则:连贯可信优先于花哨,但 Hook / 片头可花哨博关注——按 brief 调性定档(见
reference.md的"关注度 vs 可信度")。
文件结构
storyboard/
├── README.md 你正在看的这份说明
├── SKILL.md 技能本体(操作层:分镜五步 / 景别机位切换速查 / 八条质检清单)
├── reference.md 原理层(第 5、6 单元深读,每条带"在本管线里怎么落地")
└── 安装说明.txt 离线安装与纯阅读说明
同系列:shot-language(画面构图) · camera-blocking(机位走位) · storyboard(镜头序列,本仓库)。
把方法变成能力。





