eian-riso-broll
孔版双色(Riso)风格的信息 B-roll 动画。给一份口播逐字稿(可附 SRT 字幕),挑出适合做成信息动画的段落,套用 10 个现成模板(数字冲击 / 流程 / 收敛 / 前后对比 / 连接密度 / 金句 / 多选一 / 误区翻转 / 章节卡 / 截图锚点),先出静态样帧确认,再渲染 1080×1920 竖屏 mp4(无音轨;可出透明底 ProRes)。用户说「Riso 动画」「孔版风 B-roll」「eian-riso-broll」「逐字稿做信息动画」「口播配信息动画」「信息图 B-roll」,或给出逐字稿、想要高对比杂志感的竖屏信息动画时,使用此 skill。纯 HTML/CSS/GSAP 本机渲染,不调用图片生成模型;只做无角色的信息动画 —— 情绪独白、隐喻、软件操作演示不做,建议归实拍 / 角色动画 / 录屏。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/yian6557--eian-riso-broll)HTML
<a href="/listings/yian6557--eian-riso-broll"><img src="/api/listings/yian6557--eian-riso-broll/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
First install [Node.js](https://nodejs.org) 22+, Chrome (Edge or Chromium also work), and [ffmpeg](https://ffmpeg.org) (on macOS: `brew install node ffmpeg`).
Then **paste the message below to your AI coding assistant** (Claude Code, Codex, Cursor, Gemini CLI — any of them), and it will install itself:
> Install the eian-riso-broll skill for me. Repo: https://github.com/YIAN6557/eian-riso-broll . Clone it to wherever you load skills or rules (if you're Claude Code, use `~/.claude/skills/eian-riso-broll`; otherwise clone it to a suitable working directory — its `AGENTS.md` at the repo root is the guide for you). Then check that Node.js 22+, Chrome and ffmpeg are installed, run its `scripts/check_setup.mjs`, and once everything passes, tell me how to use it.
When it says everything passed, you're ready.
<details> <summary>Manual install (click to expand)</summary>
**Claude Code**:
git clone https://github.com/YIAN6557/eian-riso-broll.git ~/.claude/skills/eian-riso-broll node ~/.claude/skills/eian-riso-broll/scripts/check_setup.mjs
On Windows, use `%USERPROFILE%\.claude\skills` instead of `~/.claude/skills`. Claude picks it up from `SKILL.md` and triggers from any project once you ask.
**Codex / Cursor / Gemini CLI and others**: clone it anywhere and work inside that folder; the assistant reads [`AGENTS.md`](AGENTS.md) at the repo root:
git clone https://github.com/YIAN6557/eian-riso-broll.git cd eian-riso-broll node scripts/check_setup.mjs
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 86 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- ---
- name: eian-riso-broll
- description: 孔版双色(Riso)风格的信息 B-roll 动画。给一份口播逐字稿(可附 SRT 字幕),挑出适合做成信息动画的段落,套用 10 个现成模板(数字冲击 / 流程 / 收敛 / 前后对比 / 连接密度 / 金句 / 多选一 / 误区翻转 / 章节卡 / 截图锚点),先出静态样帧确认,再渲染 1080×1920 竖屏 mp4(无音轨;可出透明底 ProRes)。用户说「Riso 动画」「孔版风 B-roll」「eian-riso-broll」「逐字稿做信息动画」「口播配信息动画」「信息图 B-roll」,或给出逐字稿、想要高对比杂志感的竖屏信息动画时,使用此 skill。纯 HTML/CSS/GSAP 本机渲染,不调用图片生成模型;只做无角色的信息动画 —— 情绪独白、隐喻、软件操作演示不做,建议归实拍 / 角色动画 / 录屏。
- license: Eian 个人非商业使用许可 1.0;商业使用需事先书面授权(ohhhhhmya@gmail.com,见 LICENSE)
- compatibility: Node ≥ 22、Chrome 或 Chromium、ffmpeg/ffprobe。字体随 skill 分发(思源宋体 / 思源黑体 / Oswald / JetBrains Mono),macOS、Linux、Windows 渲出来一样。首次使用先跑 node scripts/check_setup.mjs。
- ---
- # Riso B-roll · 孔版双色信息动画
- **风格一句话**:一张纸,两种专色油墨。**A 墨**(深)负责所有要读的字和结构;**B 墨**(荧光)一帧只做一处重点;两墨重叠的地方自动出现第三色;B 版永远有 3px 的套印错位;所有“渐变”都用网点表达。动起来像一张海报正在被印出来:网点显影、套印“咔”地归位、盖章砸落、滚筒刷过。
- 效果参考:`demo/`(GIF + 末帧一览)。
- ## 文件地图
- | 要做什么 | 读哪里 |
- |---|---|
- | 挑段落、提炼屏幕文字 | [references/copy.md](references/copy.md) |
- | 选模板、改 DATA | [references/templates.md](references/templates.md) |
- | 视觉规则(色本、版面、字体、禁区) | [references/style.md](references/style.md) |
- | 改动效 / 写新模板(riso.js API) | [references/motion.md](references/motion.md) |
- | 渲染、质检、交付、排错 | [references/production.md](references/production.md) |
- 模板在 `templates/`,每个都是能直接渲染的完整 composition,**只改顶部的 `DATA`**。
- ## 三道门
- ```text
- Gate 1 选段表(段落 → 模板 → 屏幕文字 → 时长) → 停,等确认
- Gate 2 样帧(每条的末帧海报 + contact sheet + QA) → 停,等确认
- Gate 3 成片(mp4 + QA) → 交付
- ```
- 每道门都停下来等用户。改名单在 Gate 1 最便宜,改构图在 Gate 2 最便宜。
- **快速通道**:用户只给了一段、或明确说“直接出片 / 不用确认”时,可以合并门,但 QA 一步都不省。
- ### Gate 1 · 选段
- 按 [copy.md](references/copy.md) 读逐字稿,产出一张表:
- | # | 原话落点 | 模板 | 屏幕文字(提炼后) | 时长 | 色本 | 截图需求 |
- |---|---|---|---|---|---|---|
- 外加“落选段 → 去处”(录屏 / 实拍 / 合并进第 N 条)。
- - 一条只讲一件“能被看见”的事:一个数字、一个结构、一次对比、一句结论。
- - 相邻两条不用同一模板;同一模板全片 ≤ 2 次(章节卡系列除外)。
- - `quote`(满版深底)全片 ≤ 2 条,放在钩子或结论,制造明暗节奏。
- - 时长用 `scripts/timing.mjs` 算(有 SRT 用 SRT,没有按 4.5 字/秒估),不要拍脑袋写 5 秒。
- ### Gate 2 · 样帧
- ```bash
- P=$(node scripts/new_project.mjs 2026-10-07-主题) # 建项目,assets 整份拷入
- cp templates/number.html $P/compositions/01-xxx.html # 每条一个文件,按 01- 02- 编号
- # 只改 DATA → 渲样帧 → 质检
- node scripts/render.mjs $P/compositions/*.html --still # plates/*.png + plates/sheet.jpg
- node scripts/qa.mjs $P/compositions/*.html # qa/*-audit.png;有 error 必须修
- ```
- 自己先读 `plates/sheet.jpg` 和有问题的 `qa/*-audit.png`,修完 error 再把 sheet 发给用户。样帧就是成片的最后一帧——**样帧和成片同一个文件渲出来,天然一致**。
- ### Gate 3 · 成片
- ```bash
- node scripts/render.mjs $P/compositions/*.html # renders/*.mp4(H.264,无音轨)
- node scripts/qa.mjs $P/compositions/*.html # 再查一遍:时长、尺寸
- ```
- 交付:`renders/*.mp4` + `plates/sheet.jpg` + `STORYBOARD.md`(填好分镜表)。问用户要不要:透明底版本(`--alpha` → ProRes 4444 `.mov`,叠在口播画面上用)、拷到指定目录。
- ## 不可违反
- 1. **屏幕文字只来自逐字稿原话**:数字、名词、原句的子串。台词没说的(第 4 个类别叫什么、具体百分比)就留空,不编。能做的只有“删字”和“换行”,不改写意思。
- 2. **没有真截图就不画界面**:`shot` 模板没图时只显示“截图 · xxx · 待替换”占位,不加批注框。
- 3. **小于 100px 的字只用 A 墨**;B 墨只给大数字、压条、色块。
- 4. **信息只在 y 168–1330**;下面是字幕床,只放网点地层。
- 5. **QA 有 error 不交付**。
- 6. **不做音效**:成片只有画面、没有音轨;不加拟音、不配 BGM,声音统一在剪辑台处理。
- ## 常见坑(写新模板 / 改版面时)
- - 嵌套元素不会自动 `position:absolute`(只有 `#stage` 的直接子元素会)——容器里的子元素要自己写。
- - **先排版、后建时间轴**:`fit()` / `inkBox()` 要在任何 tween 之前调用,否则量到的是动画初始态。
- - 数字按**墨迹**对齐(`Riso.inkBox`),不要按行框——数字字体的字形会超出行框。
- - 多行文本用 `Riso.text(el, '第一行\n第二行[重点]')`,不要直接 `textContent`,否则逐字升起不生效。
README.md · README · 166 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # eian-riso-broll
- **Risograph-style info animations for talking-head videos · an AI coding-assistant workflow**
- Works with Claude Code, Codex, Cursor, Gemini CLI, and other agents.
- [简体中文](README.zh-CN.md) · English
- Hand your AI assistant the script of your talking-head video. It picks the lines worth visualizing and turns them into vertical info animations (1080×1920 mp4) in a two-color risograph print style, ready to drop into your editor.
- | Big number | Many → few | Before / after | Key quote |
- |:---:|:---:|:---:|:---:|
- |  |  |  |  |
- Ten animations made from one minute of script (the last frame of each):
- 
- > The copy comes from a [fictional sample script](examples/demo-script.md) (in Chinese); every word on screen is lifted from what's said. GIFs are compressed; the real output is 30fps HD mp4.
- ## Who it's for
- Creators who make talking-head, explainer or knowledge videos for short-video platforms. While your viewers hear you, this skill makes them **see** the number, the comparison or the conclusion you're talking about.
- - **You give**: the script (an SRT subtitle file makes timing exact).
- - **You get**: one mp4 per animation (picture only, no audio), a storyboard table and a contact sheet of every shot. A transparent version is available when you want to overlay it on your footage.
- The typography is designed for Chinese (serif display type, Chinese line limits). Latin text renders fine too.
- ## Why use it
- - **A series, not a pile of slides**: all ten templates share one paper, one pair of inks, one set of fonts and one header, so a whole episode looks consistent.
- - **Timed to your voice**: each animation lasts as long as the line it covers; with subtitles, it's matched to the exact in and out points.
- - **Never makes things up**: on-screen text is only ever cut from your own words. Categories or figures you didn't say stay blank; without a real screenshot you get a "to be replaced" placeholder, never a fake UI.
- - **Approve before rendering**: you see a storyboard first, then a still of every shot, and only then does it render, so changes stay cheap.
- - **Built for vertical video**: it keeps clear of the platform's top bar, the subtitle area and the like/comment buttons on the right, and automatically checks type size, contrast and anything running off-frame.
- - **Free, offline, local**: no image-generation models, no network. Fonts are bundled, so macOS, Windows and Linux render identically.
- ## Install
- First install [Node.js](https://nodejs.org) 22+, Chrome (Edge or Chromium also work), and [ffmpeg](https://ffmpeg.org) (on macOS: `brew install node ffmpeg`).
- Then **paste the message below to your AI coding assistant** (Claude Code, Codex, Cursor, Gemini CLI — any of them), and it will install itself:
- > Install the eian-riso-broll skill for me. Repo: https://github.com/YIAN6557/eian-riso-broll . Clone it to wherever you load skills or rules (if you're Claude Code, use `~/.claude/skills/eian-riso-broll`; otherwise clone it to a suitable working directory — its `AGENTS.md` at the repo root is the guide for you). Then check that Node.js 22+, Chrome and ffmpeg are installed, run its `scripts/check_setup.mjs`, and once everything passes, tell me how to use it.
- When it says everything passed, you're ready.
- <details>
- <summary>Manual install (click to expand)</summary>
- **Claude Code**:
- ```bash
- git clone https://github.com/YIAN6557/eian-riso-broll.git ~/.claude/skills/eian-riso-broll
- node ~/.claude/skills/eian-riso-broll/scripts/check_setup.mjs
- ```
- On Windows, use `%USERPROFILE%\.claude\skills` instead of `~/.claude/skills`. Claude picks it up from `SKILL.md` and triggers from any project once you ask.
- **Codex / Cursor / Gemini CLI and others**: clone it anywhere and work inside that folder; the assistant reads [`AGENTS.md`](AGENTS.md) at the repo root:
- ```bash
- git clone https://github.com/YIAN6557/eian-riso-broll.git
- cd eian-riso-broll
- node scripts/check_setup.mjs
- ```
- </details>
- ## How to use it
- Just ask your AI assistant, for example:
- - **A whole episode**: "Use eian-riso-broll to make info animations for this script: … (paste the script)"
- - **A single line**: "Turn this line into a Riso animation and render it straight away: 'Making one infographic used to take 40 minutes; now it takes 2.'"
- - **Matched to your voice**: "Here's my subtitle file talk.srt. Animate the third paragraph and match its length to the voiceover."
- - **For overlaying**: "Give me a transparent-background version of the last one."
- For a whole episode, the assistant works in three steps and stops for your OK after each:
- 1. **Storyboard**: which line gets which visual, the exact on-screen text and the duration. This is the cheapest moment to drop or swap shots.
- 2. **Stills**: the last frame of every animation, laid out on one sheet. Fix layout or wording here.
- 3. **Final render**: the mp4s, checked again for length and size.
- If you give it a single line or say "render it straight away", the assistant merges the steps, but never skips the checks.
- Finished files go to `~/eian-riso-broll-projects/<project name>/renders/`, one mp4 per animation.
- ## The ten templates
- Numbers match the contact sheet above.
- | # | Template | Use it when | Line from the sample |
- |---|---|---|---|
- | 01 | Myth vs. fact `versus` | "Most people think… actually…" | Good motion graphics need a hired animator → a script is enough |
- | 02 | Chapter card `title` | Part one, part two…; an opening title | Part one: see the results |
- | 03 | Big number `number` | One number strong enough to fill the frame | 12 lines worth visualizing |
- | 04 | Before / after `compare` | Two values of the same thing, bars drawn to true scale | 40 minutes before, 2 minutes now |
- | 05 | Many → few `converge` | Lots of things narrowing down to a few | 30-plus projects → 4 kinds |
- | 06 | Network `network` | A count plus connection, relationships or scale | 1,800 shots that read as one series |
- | 07 | Pick one `focus` | Several options with one highlighted | Four palettes; 70% of videos use the first |
- | 08 | Steps `steps` | 2–6 steps in order | Just 3 steps: pick lines, check stills, render |
- | 09 | Screenshot `shot` | Viewers need to see the real thing (dashboard, post, spreadsheet) | Last week's storyboard (you supply the screenshot) |
- | 10 | Key quote `quote` | The hook or the conclusion, on a full dark background | Visuals should follow what you say |
- ## Four palettes
- | Palette | Mood |
- |---|---|
- | Ink blue × fluorescent pink (default) | The most "risograph"; knowledge, tech |
- | Deep teal × orange | Warm; methods, lifestyle |
- | Navy × vermilion | Opinions, myths, warnings |
- | Ink black × bright yellow | Restrained; serious topics, data, finance |
- Use at most two per episode: one for the body, one for the opening and closing. To change colors, just tell Claude.
- ## What it doesn't do
- - **No sound**: output is picture only. Voice, sound effects and music stay in your editor.
- - **No non-informational shots**: emotional monologues, storytelling, metaphors and software walkthroughs are better served by live footage, character animation or screen recording. Claude will tell you so.
- - **No fake screenshots**: anything that needs to show the real thing needs a real screenshot from you.
- - **Vertical only, for now**: 1080×1920.
- ## FAQ
- **How long does rendering take?**
- On an Apple Silicon Mac, a 5-second animation takes about 15–20 seconds. Stills take a few seconds each.
- **Can I edit the text myself?**
- Yes. Each animation is an html file under `compositions/` in the project. Open it in a browser to preview (it loops). Edit the `DATA` block at the top, then ask Claude to render again.
- **What if the text is too long?**
- Claude cuts words from what you said rather than shrinking the type; text too small to read on a phone might as well not be there.
- **Why do a few characters look different?**
- The bundled Chinese fonts cover the 6,763 most common characters; rare ones fall back to a system font.
- **It says Chrome can't be found.**
- Set `CHROME=<path to the browser executable>` and try again; `check_setup.mjs` tells you exactly what went wrong.
- ## Manual use, without Claude
- ```bash
- cd ~/.claude/skills/eian-riso-broll
- P=$(node scripts/new_project.mjs episode-12) # create a project, prints its path
- cp templates/number.html "$P/compositions/01-number.html" # copy a template, edit DATA at the top
- node scripts/render.mjs "$P"/compositions/*.html --still # stills + contact sheet
- node scripts/qa.mjs "$P"/compositions/*.html # automatic checks
- node scripts/render.mjs "$P"/compositions/*.html # final mp4s
- node scripts/render.mjs "$P/compositions/01-number.html" --alpha # transparent (ProRes 4444)
- ```
- More detail (in Chinese): [references/production.md](references/production.md).
- ## Want to change the skill?
- Code layout, the self-test and the maintenance scripts are in [CONTRIBUTING.md](CONTRIBUTING.md).
- ## License
- For commercial licensing, contact [ohhhhhmya@gmail.com](mailto:ohhhhhmya@gmail.com).
- The package uses the custom [Eian Personal Non-Commercial License 1.0](LICENSE), with separate written commercial licensing. Individuals may install, run, and privately modify copies for non-commercial personal use, and share the videos they make with it in non-commercial personal accounts. Commercial use—including monetized accounts, advertising, sponsorships, client or employer projects, and organizational or group use—requires prior written authorization and a separately agreed fee. Buying the skill on [Agensi](https://www.agensi.io/) counts as commercial authorization, with no separate request needed. The source, templates and assets may not be redistributed.
- This is a source-available license, not an OSI-approved open-source license. GSAP and the bundled fonts keep their own licenses; see [third-party notices](THIRD_PARTY_NOTICES.md) and [license status](LICENSE-STATUS.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.