Index of every page on this site: llms.txt
All skills
conardli avatar

/motion-showreel

@f2d7ade
by conardliconardli/garden-skills16k stars
1,762
Run it yourself

用代码制作图形、文字或界面动画视频,输出 MP4 和可编辑源码,最长 20 分钟。适用于动效作品集、产品片、UI 动效、动态排版、Logo 片头、生成艺术与讲解视频;支持独立选择 BGM/音效来源、用户口播,以及用用户提供的口播稿通过 TTS 合成语音。不用于实拍制作、写实人物生成或一般视频剪辑。

Use this Skill: https://skilld.dev/gh/conardli/garden-skills/motion-showreel

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

README.zh-CN.md

≈5.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Motion Showreel Skill

用代码制作动效视频:从几秒的 Logo 演绎到最长 20 分钟的分章内容,支持配乐、音效、用户口播和 TTS,交付 MP4 与可编辑源码。

English · 返回集合首页

Motion Showreel Skill


这是什么?

motion-showreel 把想法做成完整视频(MP4 + 可编辑源码),内容以图形、文字或界面动画为主。Agent 先与你确认需求和风格,再写一个「画面只由时间决定」的网页逐帧渲染。画面与声音共用时间表;有口播时先确定真实语音节奏,再制作画面。

适合:

  • 动效作品集
  • 产品宣传短片、发布预告(只用用户给的事实和截图)
  • UI 动效演示:形变链、微交互
  • 动态排版、金句卡点
  • Logo 演绎、片头、频道 bumper
  • 生成艺术循环、数据爆点
  • 年代回顾:随段落切换媒介(像素 → 矢量 → 3D……)

短片常见 5–60 秒,也支持最长 20 分钟的分章视频,以及根据用户原稿或录音制作的口播讲解。需要点击推进的演示或文章转口播稿,用 web-video-presentation;网页和原型用 web-design-engineer。不生成写实人物、不拍摄实景,也不承担一般视频剪辑。

开始前需要明确:核心主题与内容、时长、横屏或竖屏、BGM 来源、音效来源、口播方式。BGM 与音效分别选择 AI 合成、用户提供,也可关闭。口播可选无口播、TTS 或用户录音;使用 TTS 时,口播稿必须由用户提供,并配置相应服务的 API(支持 Gemini、MiniMax 和自定义适配器)。已有配置可复用。指定时长与真实口播冲突时会先确认,不会自动截断、变速或改稿。

相关资料、受众与平台、风格可选。你已说明具体内容并希望 AI 生成时,Agent 据此制作;内容不足时补问资料或调研,口播稿里的信息会直接使用。真实事实和品牌素材仍需准确。未指定风格时,提供三个方向供你选择。


作品展示

下面每一支都是 Agent 用这个 Skill 根据一句简短的需求做出来的,多数需求只给了风格,加一句「其余你来定」。预览是 4 秒、12 fps 的片段,原片是 1920×1080、30fps、有声。

<table> <tr> <td width="50%" valign="top"><img src="../../dist/imgs/motion-showreel/promo.webp" alt="Motion Showreel 宣传片:每一拍换一种媒介" width="100%"><br/><strong>Motion Showreel 宣传片</strong> · 80 秒<br/><sub>Skill 自己的宣传片。一个橙色的点每拍换一种媒介重画一遍(水墨、剪纸、孔版印刷、CRT、拼贴、玻璃、黏土……),最后炸成 22 种风格同时运行的一面墙;合成配乐的配器跟着媒介一起换。</sub></td> <td width="50%" valign="top"><img src="../../dist/imgs/motion-showreel/afterglow.webp" alt="AFTERGLOW 合成波片头" width="100%"><br/><strong>AFTERGLOW</strong> · 19 秒 · <code>synthwave-neon</code><br/><sub>一张虚构专辑的片头。镜头贴地穿过一道道霓虹门,穿过最后一道之后黑半拍,镀铬大字在 drop 上从地平线里弹起来。</sub></td> </tr> <tr> <td width="50%" valign="top"><img src="../../dist/imgs/motion-showreel/boink.webp" alt="boink 软萌 3D 连锁反应" width="100%"><br/><strong>boink</strong> · 18 秒 · <code>soft-3d-toy</code><br/><sub>一镜到底的连锁反应(对标本田「Cog」广告)。每块多米诺骨牌是一个马林巴音;果冻砸地后,一圈挤压冲击波扫过整个世界,开场那颗小球最后落成字母 i 上的点。</sub></td> <td width="50%" valign="top"><img src="../../dist/imgs/motion-showreel/last-stroke.webp" alt="最后一笔 墨线火柴人游戏预告" width="100%"><br/><strong>最后一笔 LAST STROKE</strong> · 30 秒 · 自定义「墨线火柴人」风格<br/><sub>一款虚构小游戏的预告:你画下的每一笔都会成真。主角一笔横穿 40 个敌人,之后是全片唯一一拍完全静音,然后所有敌人炸成墨点,那一笔变成片名。</sub></td> </tr> <tr> <td width="50%" valign="top"><img src="../../dist/imgs/motion-showreel/umbra.webp" alt="UMBRA 本影 日全食电影片头" width="100%"><br/><strong>UMBRA 本影</strong> · 27 秒 · <code>cinematic-title</code><br/><sub>一部虚构的日全食电影的片头,2.39:1 黑边。一拍绝对静音之后,最后一颗贝利珠炸成钻石环,片名在月亮的黑盘里显影。钢琴用 Salamander 采样(第 2 档),上面叠第 1 档合成的预告片音效(boom、braam)。</sub></td> <td width="50%" valign="top"><br/><strong>每支片子交付什么</strong><br/><sub> 实际导出的 MP4(工作区版为 <code>out/editor-&lt;task-id&gt;.mp4</code>)+ <code>out/poster.png</code><br/> <code>brief.md</code>:可以复用的结构化提示词<br/> <code>index.html</code> / <code>timeline.js</code> / <code>score.mjs</code>:可编辑的源码<br/> <code>sh build.sh</code>:整片重建,也可以只重渲一段<br/> <code>qa/</code>:抽帧图、手机尺寸检查、按镜头的运动报告、文字框景标记图、波形图和频谱图<br/> 技术检查结果(全部 PASS)+ 如实记录的审片记录 </sub></td> </tr> </table>

核心理念

  • 画面 = 时间的函数:页面暴露确定性的 window.render(t)(不用 Math.random、定时器、rAF、CSS 动画),Playwright 逐帧截图,ffmpeg 合成 MP4。运动模糊(--subframes)、超采样(--dpr)、胶片颗粒(--grain)都是渲染参数,不写在页面里。
  • 画面和声音共用一张时间表:timeline.js 里写着每个切点、撞击和音效,页面和配乐都从它读取,卡点精确到帧。
  • 先找对标,再想三个结构:动笔前先挑 1–2 个对标作品,写清学什么、不学什么,再写三个候选结构。第一个冒出来的想法往往是这个风格的陈词滥调。参考视频可以量:inspect.mjs grid 找出剪点和它们落的节拍网格,heat 看每段里哪里在动。
  • 风格库是起点,不是选择题:43 种风格,每种写明不变的规则(质感、配色、字体、运动、镜头语法、声音调色板、原生手法、坑)。每种还列了 8–12 个辨识信号(按主题挑 2–3 个),并把这个风格最俗的版本直接写出来,选了合成波也不会每次都是网格加日落。可以直接用、改造、混搭,也可以按模板自定义。
  • 声音也要先定方向:brief 里声音和画面同等对待,写清对标、律动、和声、配器、戏剧曲线;再配一份声音的「默认味」清单,免得几支片子听起来像同一首歌。
  • 想看过程,就提前打开。 初始反馈中表达「边做边看」「实时进度」时,Agent 会打开制作进度页,逐阶段展示风格帧、口播样例、镜头和混音;完成后在同一页预览确认。只发布已自查的阶段成果,沿用原制作和验收标准,见 references/progress.md。
  • 需求、风格与最终预览分别确认:先补齐必填信息并确认需求,再确认风格帧;制作完成后主动打开工作区,预览通过再导出 MP4。用户没定风格时给 3 个拉开差距的方向;「给我惊喜」保留创意自由,不代表替用户默认制作规格。
  • 口播优先:TTS 使用用户原稿,或导入用户录音与真实句段时间戳;画面跟随讲述,BGM 和音效在说话期间收敛。长片按章构建并保留缓存,失败后可继续。
  • 连续画面:分镜记录对象的前后状态和空间承接,镜头可跨句发展。关键词事件使用真实词时间或人工锚点;带声音预览支持拖动和逐帧检查。依赖运动的方向,随风格帧一起确认连续小样。
  • 技术验收和审美判断分开:尺寸、帧率、时长、帧数、黑帧、响度、真峰值、循环接缝、确定性这些由程序判定,必须全部 PASS。旁边还有量出来的审片材料,不挡构建:按镜头的运动(含突然的跳变和单帧闪),以及文字框景(字被画面切掉、叠字、落进安全区、字太小)。审片记录只是帮用户更快地看片,不能代替用户自己看。
  • 放手模式:用户说「全力以赴」「给我惊喜」时,只守底线和技术管线,风格、结构、手法都交给模型判断。

工作流

0  环境检查(一次)
1  需求确认 ─────────── 补齐必要信息、汇总要求 → 🛑 等你确认
2  brief.md ─────────── 对标 → 用途 + 风格 → 分镜 + 声音计划
3  风格帧 ───────────── 已定风格:3 张帧;未定风格:3 个方向各 1 张 → 🛑 等你确认
4  制作 ─────────────── 有口播先确定真实音频时间轴 → 逐镜头 → 网页自检
5  配乐与混音 ───────── BGM / 音效独立来源;人声优先
6  工作区预览 ───────── 主动打开工作区,修改后复看 → 🛑 等你确认导出
7  导出与验收 ───────── 合成 MP4 → 技术检查(必须 PASS)+ 成片复核
8  交付

默认工作区与导出确认见 references/editor.md。口播与独立轨混音见 references/narration.md;超过 2 分钟的章节构建、缓存与审片见 references/long-form.md。旧短片的全部风格、两档配乐、卡点、循环和渲染参数继续保留。


风格库

43 种风格,分 8 组:图形与排版、界面与产品、复古与屏幕、3D 与材质、生成与抽象、插画与漫画、手作、电影感。下面是代码渲染的风格样片,最后新增的三段均为 4 秒、20 fps 的无缝循环动图:

<table> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-ukiyo-e.webp" alt="ukiyo-e" /><br /><sub><code>ukiyo-e</code> 浮世绘木版</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-glass-material.webp" alt="glass-material" /><br /><sub><code>glass-material</code> 玻璃金属材质</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-kinetic-brutalist.webp" alt="kinetic-brutalist" /><br /><sub><code>kinetic-brutalist</code> 粗野动态排版</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-swiss-editorial.webp" alt="swiss-editorial" /><br /><sub><code>swiss-editorial</code> 瑞士编辑</sub></td> </tr> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-ink-wash.webp" alt="ink-wash" /><br /><sub><code>ink-wash</code> 水墨</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-risograph-print.webp" alt="risograph-print" /><br /><sub><code>risograph-print</code> 孔版印刷</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-editorial-collage.webp" alt="editorial-collage" /><br /><sub><code>editorial-collage</code> 杂志拼贴</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-isometric-infographic.webp" alt="isometric-infographic" /><br /><sub><code>isometric-infographic</code> 等距信息图</sub></td> </tr> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-liquid-shader.webp" alt="liquid-shader" /><br /><sub><code>liquid-shader</code> 液态着色器</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-data-motion.webp" alt="data-motion" /><br /><sub><code>data-motion</code> 数据动效</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-generative-geometry.webp" alt="generative-geometry" /><br /><sub><code>generative-geometry</code> 生成几何</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-pixel-game.webp" alt="pixel-game" /><br /><sub><code>pixel-game</code> 像素游戏</sub></td> </tr> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-synthwave-neon.webp" alt="synthwave-neon" /><br /><sub><code>synthwave-neon</code> 合成波霓虹</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-paper-cut.webp" alt="paper-cut" /><br /><sub><code>paper-cut</code> 剪纸</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-minimal-ui.webp" alt="minimal-ui" /><br /><sub><code>minimal-ui</code> 极简界面</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-comic-pop.webp" alt="comic-pop" /><br /><sub><code>comic-pop</code> 漫画分格</sub></td> </tr> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-flat-vector.webp" alt="flat-vector" /><br /><sub><code>flat-vector</code> 扁平插画</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-guochao.webp" alt="guochao" /><br /><sub><code>guochao</code> 国潮纹样</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-painterly.webp" alt="painterly" /><br /><sub><code>painterly</code> 油画笔触</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-glitch-digital.webp" alt="glitch-digital" /><br /><sub><code>glitch-digital</code> 数字故障</sub></td> </tr> <tr> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-soft-organic.webp" alt="soft-organic" /><br /><sub><code>soft-organic</code> 柔光有机</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-hologram-hud.webp" alt="hologram-hud" /><br /><sub><code>hologram-hud</code> 全息空间界面</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-particle-field.webp" alt="particle-field" /><br /><sub><code>particle-field</code> 粒子场</sub></td> <td align="center" width="25%"><img src="../../dist/imgs/motion-showreel/style-art-deco.webp" alt="art-deco" /><br /><sub><code>art-deco</code> 装饰艺术</sub></td> </tr> </table>

<sub>库里还有:<code>dark-keynote</code> · <code>soft-3d-toy</code> · <code>crt-vhs</code> · <code>terminal-ascii</code> · <code>crayon-storybook</code> · <code>copperplate-engraving</code> · <code>cinematic-title</code> · <code>mixed-media-era</code>。目录、三方向规则和混搭方法见 <a href="./references/styles/INDEX.md"><code>references/styles/INDEX.md</code></a>。</sub>

其他风格规则:装饰艺术、一笔线描、工程蓝图、全息空间界面、彩色玻璃镶嵌、移轴微缩、像素立体场景、80 年代赛璐璐动画、橡皮管动画、透光皮影。沿用同一模板,写明材质、运动规则和可选技术方向。

也可选择白板手绘解说、数学/概念形变和泥金手抄本。


声音

档 引擎 适合
第 1 档 · 内置合成(默认) score.mjs,零依赖、完全确定:鼓与手鼓、贝斯、铺底、拨弦、敲击乐(马林巴 / 钢片琴 / 卡林巴 / 钢鼓)、风琴、人声铺底、FM 钟声、环境底噪(磁带、黑胶、风、雨)、swing / 步进节奏、侧链、bitcrush、磁带抖动 电子、界面、复古、抽象、手作、lo-fi
第 2 档 · Tone.js score.tone.js,在无头 Chromium 里离线渲染:采样乐器(Salamander 钢琴,CC BY)、卷积混响、合唱 / 相位 / 失真 电影感、高端产品、需要真实乐器和空间感的片子
用户曲子 audio.mjs beats 测出 BPM、拍点、强拍和 drop(有 librosa 时优先使用),再叠音效 已有配乐

两档可以叠用:底下是 Tone.js 的音乐,上面叠合成音效,最后统一做母带。所有混音都处理到 −14 LUFS / −1 dBTP。模型听不到声音,所以 audio.mjs check 会输出响度、频段平衡和静音段,量出每个声明过的 drop 前有没有「呼吸」,并画出波形图和频谱图给模型看。


目录结构

skills/motion-showreel/
├── SKILL.md                 工作流 + 底线 + 工具速查
├── README.md / README.zh-CN.md
├── manifest.json
├── references/
│   ├── formats.md           用途(含口播讲解与分章长片)
│   ├── styles/              INDEX.md + _template.md + 40 个风格文件
│   ├── craft.md             节奏、运动、转场、镜头、排版、配色、质感、签名时刻、默认味清单
│   ├── sound.md             声音方向、合成 API、Tone.js、戏剧曲线、律动 / 和声词汇、混音、声音默认味
│   ├── narration.md         用户原稿 TTS、录音时间戳、关键词事件与人声优先混音
│   ├── long-form.md         最长 20 分钟、章节清单、缓存和断点重建
│   ├── stack.md             页面契约、确定性、各技术的坑、字体、多画幅、性能
│   ├── recipes.md           现成写法(遮罩逐字、形变链、粒子组字、无缝循环、WebGL 后期、Canvas 伪 3D……)
│   ├── brief-template.md    每支片子的结构化提示词模板
│   └── review.md            技术检查、审片表、独立审片、常见问题、交付清单
├── scripts/
│   ├── setup.sh · check-env.mjs · scaffold.sh
│   ├── render.mjs           静帧、拼图、三方向、封面、确定性、文字框景、小样、正片
│   ├── audio.mjs            build · check · beats · samples · mux
│   ├── narration.mjs        tts · import · mix · check
│   ├── progress.mjs         按需发布制作阶段、图片/音频成果与稳定预览
│   ├── editor.mjs           默认审片工作区、分轨编辑、保存、确认后导出
│   ├── preview.mjs          轻量调试:带声音播放、拖动、逐帧与预览倍速
│   ├── build-long.mjs       持久章节缓存、失败重试、拼接与验收
│   ├── inspect.mjs          qa · sheet · phone · strip · frames · motion · loop · grid · heat
│   ├── lib/                 合成器、Tone.js 渲染、FFT、浏览器、项目工具、帧分析、文字钩子
│   └── test/                回归测试(npm test)
└── assets/starter/          页面、motion/timeline/narration 工具、预览控件、配乐与 build.sh

快速开始

先安装 Skill(见集合首页),然后在 Skill 目录里跑一次初始化:

sh scripts/setup.sh        # 安装 Playwright + Chromium + Tone.js,再做环境检查

依赖:Node 18+ 和 ffmpeg(需要在 PATH 里)。初始化脚本不会替你安装系统软件。

然后直接说:

给我们的发布会做一支 15 秒的动效视频,全力以赴。
给「Garden」做一个 Logo 动画,瑞士编辑风。
用这三张截图做一支 20 秒的产品宣传短片,要配乐。
做一个 6 秒的无缝循环生成艺术,不要声音。

Agent 会先补问缺失项并停下来确认,再建好 <slug>/、给你看风格帧;风格确认后自主完成画面和配乐,再默认打开剪辑工作区让你预览;你点击导出或确认当前版本可以导出后,才生成 MP4、验收和交付。无声片、循环片也先预览,长片先逐章预览。上面的简短需求可直接发起,但缺失的时长、画幅、BGM/音效来源和口播方式不会被静默填成默认值。之后想重建或微调:

node scripts/editor.mjs <slug> --size 1920x1080 --fps 30   # 默认先打开工作区,预览通过后点击导出
sh <slug>/build.sh                                   # 用户确认后重建原版,不自动读取工作区音轨编辑
node scripts/preview.mjs <slug> --size 1920x1080 --fps 30   # 轻量调试预览
node scripts/render.mjs <slug> --start 6 --duration 3 --out out/seg.mp4   # 只重渲一段
node scripts/build-long.mjs <slug>/chapters.json       # 长片按章构建,再次运行复用有效缓存

工具自带回归测试:cd scripts && npm test。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2d3 checks · Risk SAFE
  • Gen Agent Trust Hub2d

    The 'motion-showreel' skill is a comprehensive toolkit for generating motion graphics videos from code. It uses Playwright for frame rendering and FFmpeg for video/audio processing. The skill supports TTS narration via official Gemini and MiniMax APIs, ensuring that credentials are kept in environment variables. It implements robust path validation to prevent directory traversal and uses standard dependency management. All external downloads, including browser binaries and audio samples, are from well-known and trusted sources. No malicious patterns were detected.

  • Socket2d

    No alerts

  • Snyk2d

    Risk: MEDIUM · 1 issue

Signed by skilld at f2d7ade. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 4 weeks ago

README badge

README badge for conardli/garden-skills/motion-showreel