space-video-broll
动效导演 + B-roll 生成器。从一段文字/脚本/视频,一次性产出 30 秒以上的动效 B-roll 视频(HTML→确定性 MP4)。不做 PPT 式翻页,从「视觉隐喻 + 运动」出发;内置多种设计风格(暗色 SaaS 魔术、黑白打字机、暖色编辑、极简白、蓝图网格);产出一律不用 emoji,用排版/几何/SVG 线性图标。当用户说「做 B-roll」「做个动效视频」「motion 开场」「文字动画」「概念动画」「HTML 转视频」「这段配个画面」「30秒 broll」时触发。
How do I install this agent skill?
npx skills add https://github.com/spacezephyr/creator-buddy --skill space-video-brollIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The space-video-broll skill is a motion design and B-roll generation tool that converts text or video inputs into deterministic MP4 videos using a pipeline of HTML templates, Puppeteer, and FFmpeg. The analysis found no malicious patterns; the skill's use of command-line tools and external downloads is consistent with its primary purpose of media processing.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
space-video-broll · 动效导演
从一段文字/脚本/视频,产出一条能当视频看、不像 PPT 的动效 B-roll(默认 30 秒以上,一次成片)。
核心信条:从运动出发,不从页面出发
不要从「一页一页卡片」开始。先给内容找一个能动起来的视觉隐喻:
河流 / 网络 / 分支树 / 轨道 / 流水线 / 蜂群 / 坍缩 / 压缩 / 扫描 / 交接 / 增长循环 / 地图路径 / 堆栈 / 波形 / 时钟 / 透镜 / 机器
文字是锚点,不是主角。一个 beat 如果要靠读一大段字才成立,就把它改成运动、结构、符号或图形。
输入:文字 或 视频
- 文字/脚本:直接抽 beats。
- 视频/逐字稿:先读内容(
space-video-topic的逐字稿),抽出讲了哪几件事 → beats。 - 缺参数不追问,除非答案会改变产出路线。默认竖屏 720×896 或按
space-video-edit配置,默认 30–40 秒。
工作流
1. 运动论点(一句话)
写死这一句再往下:
这条视频靠「<视觉隐喻>」从<起始状态>变成<结束状态>,来证明<核心主张>。
找不到能动的隐喻,就停下来先发明一个,别开始排场景。
2. Beat 图(连续时间轴,不是页)
排一条连续时间轴,每个 beat 写清:
| 字段 | 说明 |
|---|---|
time | 起止秒 |
job | 钩子 / 揭示 / 对比 / 机制 / 结果 / 证明 / 收尾 |
mover | 这个 beat 里承载运动的主对象 |
change | 屏幕上物理上发生了什么变化 |
camera | 推/拉/摇/视差/环绕/裁切/稳定 |
text | 标题/标签/计数/字幕/无 |
asset | 代码SVG/生成图/截图/图标/无 |
3. Anti-PPT 质量门(硬性)
- ≥80% 的 beat 必须有「淡入/滑入」以外的可见状态变化(生长、聚合、坍缩、路径绘制、替换、变形、点亮)。
- 不满足就退回重排——宁可少几个 beat,也不要一堆卡片轮流淡入。
- 主对象在它最显眼的那帧要足够大,不能像远处的小道具。
4. 选风格(见 references/design-styles.md)
内置风格,按内容/平台选一个,或用户指定:
| 风格 | 适合 | 关键词 |
|---|---|---|
dark-saas | AI/产品/SaaS 演示 | 黑色星场、底部紫光、大字动态排版、青→品红 CTA |
bw-typewriter | 观点/开场/悬念 | 纯黑白、大字逐字出现、打字节奏 |
warm-editorial | 小红书/生活/自媒体 | 暖粉底、圆角、红色强调 |
minimal-light | 教程/干货/极简 | 白底、细线、单一强调色 |
blueprint-grid | 技术/架构/流程 | 深色网格、节点连线、扫描感 |
5. 无 Emoji 铁律
产出一律不用 emoji。 需要图标时用:几何形状、数字、SVG 线性图标(自己画 path)、纯文字 chip。emoji 在渲染里字重/对齐不可控,且廉价。
6. 渲染(一次成 30 秒+ 单片)
用自带渲染器把一个多场景 HTML 渲成一条完整 MP4:
node scripts/render.mjs <composition.html> <out.mp4> [fps=30]
- HTML 用
scripts/timeline.js组织多个场景:每个场景声明start/dur和update(lt, p),seek(t)自动分发。 - HTML 暴露
window.DURATION(秒) 和window.seek(t)(纯函数、不依赖时钟,保证确定性)。 - 30 秒 = 900 帧,渲染放后台跑。示例见
scripts/example-composition.html。
时长预设(参考 rn 系列)
| 预设 | 时长 | beat 数 |
|---|---|---|
sting | 8–12s | 3–4 |
standard | 30–40s | 6–8 |
extended | 50–70s | 9–12 |
默认 standard。
交接
- 上游:
space-video-script的 beats/画面需求,或用户一段文字/一条视频 - 下游:
04_broll/<名字>.mp4→space-video-edit合成,或直接单发
编排(复用已有能力)
- 有 hyperframes CLI → 走
hyperframes/hyperframes-cli/hyperframes-media - 已有 Remotion 工程 → 走
remotion-video/remotion-to-hyperframes - 复杂动画写法 → 走
gsap/animejs/css-animations/waapi/three/lottie - 参考片复刻 + QC → 见
references/replica-and-qc.md
核心原则
- 运动优先:先找会动的隐喻,再排场景
- Anti-PPT:≥80% beat 有真实状态变化,否则重排
- 无 emoji:SVG 线性图标 / 几何 / 数字 / 文字
- 一次成片:默认 30 秒+ 连续多场景,不是零散小片
- 确定性:seek 驱动、相同输入相同输出
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/spacezephyr/creator-buddy/space-video-broll">View space-video-broll on skillZs</a>