REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
把一个主题做成有配音、字幕、封面的讲解分析类视频 —— 全本地、用 HTML 写画面,稳定音画同步。 面向 AI 编程智能体的确定性 HTML → MP4 渲染流水线。
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/skills/onemoh-html-explainer)同じ作業で AI をサービスにつなぐ MCP
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
同じ種類の作業。Skill 一覧と同じ並び
| これ html-explainer | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| 作者 | OneMoh | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skill 数 | 1 | 1 | 1 | 1 | 1 |
| GitHub スター | 312 | 463,670 | 233,682 | 148,887 | 143,987 |
| 最終コード更新 | 2026年11月16日 | 2026年11月17日 | 2026年4月20日 | 2026年11月17日 | 2026年11月16日 |
| ライセンス | MIT | MIT | – | Apache-2.0 | MIT |
OneMoh による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません
MCP = 手
AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。
Skill = 手順書
作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。
重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。
Claude CodeCodexCursorGemini CLI
提供元の README と repo のフォルダから判断
GitHub account OneMoh (person), 4 years old
★ 312 stars, few users so far · code last changed 2026年11月16日
31 scripts that can run on a computer: assets/gsap.min.js, assets/motion.js, package_skill.py, scripts/bench_render.py and 27 more
Could not check every script (some are too large); read them first
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 005afb9 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
まず:どの AI を使っていますか
使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます
Uploading to claude.ai would fail: the description is over 200 characters (395). Use "Let the AI install it" instead
この文をコピーして Claude Code のチャットに貼り付けます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code を開き直し、/html-explainer と入力するか関連する作業を頼むと Claude が自動で使います
Checked against official docs 2026年11月12日 · Source: code.claude.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます
ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
html-explainer フォルダを ~/.agents/skills/html-explainer に置きます
~ はホームフォルダ($HOME)です
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます
この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
この文をコピーして Cursor のチャットに貼り付けます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Cursor の Agent チャットで / を入力し html-explainer を選ぶ
Checked against official docs 2026年11月12日 · Source: cursor.com
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
コマンドを確認中 · 確認が通るとコピーボタンが出ます
Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。
2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認
以下は提供元の repo の文章で、PopNx MCP の指示ではありません
最初の 8,000 文字を表示 · GitHub で全文を開く
---
name: html-explainer
version: 2.0.9
description: 把任意主题做成讲解/科普视频并渲染成 MP4(HTML/CSS/GSAP 画面 + 确定性逐帧渲染 + 配音 + 词级硬字幕)。触发场景:要做科普/讲解/教学/知识/产品类视频、「讲一下 X 做成视频」、要挑某种视觉风格(极简/数据/赛博/电影感/品牌)出片、要出抖音封面/竖版封面/9:16 封面、要用 html-video 那种模板化画面但更稳的音画同步、anything2explainer 换 HTML 渲染,或提到 html-explainer / HTML 讲解视频 / explainer video / MG 视频。内置 23 个模板风格(8 类)与 40+ 动作词汇的动效库,主题驱动模板编排;支持 4K60、快门运动模糊、多进程提速、断点续渲;流程含六个用户确认点(渲染通道是硬闸门)。独立可移植,不依赖 html-video / anything2explainer。
agent_created: true
---
# html-explainer
> **定位**:`anything2explainer` 的流程与音画同步 + `html-video` 的 **23 个模板风格库**,
> 渲染层独立实现。作者 **Moh**,MIT 许可(第三方声明见 `THIRD_PARTY_NOTICES.md`)。
>
> **零外部依赖**:不需要 Remotion/npm 工程,不需要 html-video 仓库/Studio/pnpm/agent 后端。
> 技能自带:GSAP(离线)、playwright-core、渲染器、TTS/字幕/时间轴/主题/QC/封面全套脚本。
> 对两个来源项目的引用**只存在于注释署名里**,运行时不读它们的任何文件。
> 风格库是**抄下来的设计规范文本**(`references/style-catalog.md`),来源 `html-video`(Apache-2.0),
> 类比:把菜谱抄回家,之后做菜不需要原餐厅营业。
**v2.0 新增能力(全部可选、向下兼容;不用就是 v1.4 行为)**
| 能力 | 入口 | 文档 |
|---|---|---|
| **动效库**(40+ 动作词汇) | `assets/motion.js` → `window.HXM` | `references/motion-library.md` |
| **主题驱动模板编排**(挑风格 / 混用 / 动态开头) | `scripts/style_director.py` | `references/style-director.md` |
| **画质帧率档位 + 快门运动模糊 + 提速** | `scripts/render_video.mjs --profile/--quality/--fps/--shutter-only/--motion-hold` | `references/render-profiles.md` |
| **渲染基准测试**(优化前后对比) | `scripts/bench_render.py` | `references/render-profiles.md` |
| **宣传片范式**(去模板化:模板只吸纳配色/字体/时序三层) | 设计方法 | `references/showcase-mode.md` |
| **库全量演示编排**(统一舞台 + 节拍网格 + 标签常驻) | 设计方法 | `references/library-showcase.md` |
| **确认闸门**(六个确认点由用户拍板才放行) | `scripts/gate_check.py` | `SKILL.md` 流程第 3 步 |
| **★ 渲染通道确认**(渲染前必问:`png-fast` / `jpeg q95` / `png` / `jpeg q82`,**默认推荐 `png-fast`**,附速度与描述) | `consent.json` 的 `render_channel` + `gate_check.py --phase render` | `SKILL.md` 确认点 5 · `references/render-profiles.md` §0 |
把一个主题做成**原创**讲解视频:任意风格的 MG 画面(HTML/CSS/GSAP,1920×1080 或竖版)、
配音(edge-tts)、词级对齐硬字幕、全局进度条。一句话一个场景,画面节拍直接锚在
吐字时刻上(`B('块文本')` 节拍器)。
## ★ 画面风格库(23 个模板 / 8 个类别)
**不要自己从零想画面 —— 先从风格库里挑;多个风格要混用时用编排器自动挑(见下)。**
挑出候选后交用户拍板(见**确认点 0**),不许静默自选。
完整目录(含每种的画布/字体/时间轴/配色纪律)
见 **`references/style-catalog.md`**;怎么改编成合规帧见 **`references/template-guide.md`**。
**两种用法的深度不同,先分清在做哪一种**:
| 你在做 | 怎么用风格库 | 读这篇 |
|---|---|---|
| **讲解片**(默认) | 从 23 个模板里**挑一个**,按 `template-guide.md` 改编成帧 | `references/template-guide.md` |
| **宣传片 / 发布片**(去模板化) | 只从模板**吸纳配色 / 字体 / 时序骨架三层**,画面语言用 `assets/motion.js` 重写 —— **不搬模板画面** | **`references/showcase-mode.md`** |
| **要全量展示某个库**(40+ 动效 / 23 个模板) | 统一舞台 + 节拍网格 + 标签常驻,把「N 个动作」演成「一个动作语言的 N 拍」 | **`references/library-showcase.md`** |
> 判据:成片能被认出「这是 bold-signal 模板」= 吸纳过头;只能说「颜色像 xx、节奏像 yy」= 深度对了。
> **★ v2.0:不要一片只用一个模板。** 用 `scripts/style_director.py` 读解说词,
> 自动给每场挑主风格(按角色/时长/关键词打分)、按需搭次风格做**局部替换**、
> 决定**动态开头变体**与**场间转场**、并算出每场的**动效强度**。
> 详见 `references/style-director.md`。核心价值:**让模板服务于主题,而不是让主题被模板限制**。
| 类别 | 可用风格 |
|---|---|
| 演示 / 标题卡 | 大胆海报帧、大胆信号卡帧、奢华极简留白帧、创意电压分屏帧、电光工作室分屏帧、故障艺术标题帧、Kinetic Type、Swiss Grid、Warm Grain |
| 数据可视化 | NYT 风数据图表帧、数据滚动帧、NYT Graph、瑞士网格数据帧 |
| 图解 / 流程 | 东方柔和有机帧、Decision Tree |
| 氛围 / 空镜 | 胶片漏光电影帧 |
| 营销 / Hero | 流体背景 Hero 帧 |
| 片头片尾 | 品牌 Logo 收尾帧 |
| 社媒竖版 | Play Mode、Vignelli(9:16)|
| 产品演示 | Product Promo、Product Promo · 30s |
| 特效 | VFX 文字光标 |
**两类模板、两种改编成本**(速查表「类型」列):
| 类型 | 数量 | 处理 |
|---|---|---|
| **★ rich** | 12 | 单文件 + 纯 CSS `@keyframes`。**零改动可渲染** —— 只需①换系统字体栈(删 Google Fonts)②让出底部字幕带③填真实内容 |
| **gsap** | 11 | 多 composition + CDN GSAP(或 Remotion)。**不要搬代码**,只取视觉 DNA 用 CSS keyframes 重写(搬进来会得到静止首帧且零报错,见 `lessons.md` #9)|
> 时长档要匹配内容:`frame-bold-signal` 是 3–6s 的短片花,拉长到 20s 会空。
> 长段(>10s)优先选 3–30s 档的(Swiss Grid / Kinetic Type / NYT Graph / Warm Grain)。
## 何时用 / 不用
- 用:给主题/文章/文档做讲解视频;要挑某种视觉风格出片;要 html-video 那种模板化画面但要求音画稳;要 anything2explainer 流程但不想装 Remotion。
- 不用:复刻现有视频、真人口播、实拍为主;要 Remotion/React 代码动画本体(那是 anything2explainer 的领域)。
## 环境(首台机器跑一次)
```bash
bash <skill>/setup_env.sh # 自检;--install 联网补装
```
依赖:Python≥3.9(edge-tts==7.2.8 钉死 / numpy / pillow / imageio-ffmpeg)、Node≥18、
**火山引擎零额外依赖**(`tts_volcano.py` 只用标准库 `urllib`,不需要装任何 SDK)。
Chrome 或 Edge(几乎必有;都没有才下载 playwright chromium ~115MB)、ffmpeg(PATH 或
imageio-ffmpeg 静态二进制自动回退)。Windows 注意:项目路径全 ASCII;给 Node/Python
传 `C:/...` 正斜杠路径;别用 heredoc 给 Python 传正则。
## 命令流水线(项目目录内,顺序不能乱)
```bash
PY=<venv python 绝对路径> # 派子 agent 时必须展开成绝对路径写进 prompt
"$PY" <skill>/scripts/new_project.py <dir> <slug> --topic "主题" # 阶段 0 建项目
"$PY" <skill>/scripts/tts_setup.py --project . # ★ 先定配音方案 + 音色(问用户:edge / 火山)
"$PY" <skill>/scripts/tts_build.py --project . # 配音:audio/*.mp3 + manifest
"$PY" <skill>/scripts/timeline_build.py --project . # 全局时间轴:layout.json + narration-full.mp3
"$PY" <skill>/scripts/subs.py --project . # 字幕:subs.json + beats.js + srt/vtt
"$PY" <skill>/scripts/check_beats_refs.py --project . # ★ 节拍引用校验:B()/Be() 是否都能解析(前缀匹配,失配秒级报出可用块)
"$PY" <skill>/scripts/style_director.py --project . # ★ v2.0 风格编排:读解说词给每场挑主/次风格 + 开场变体 + 转场 + 动效强度 → style-plan.json
"$PY" <skill>/scripts/gate_check.py --project . # ★★ 确认闸门:六个确认点未由用户拍板 → 拒绝放行(缺 consent.json 用 --init 生成)
"$PY" <skill>/scripts/gate_check.py --project . --phase render # ★★ 渲染前必过:render_channel(渲染通道)未拍板 → 拒绝渲染
"$PY" <skill>/scripts/lint_frames.py --project . # 静态体检:八条契约违规(渲染前一秒出结果,比渲完再发现便宜得多)
node <skill>/scripts/check_layout.mjs . # ★ 几何体检:越界 / 侵入字幕带 / 元素互相遮挡(lint 看不见几何)
node <skill>/scripts/render_video.mjs . [--audio audio/narration-full.mp3] [--profile draft|balanced|final|master] [--quality 1080p|2k|4k] [--fps 30|60] [--shutter 180] [--shutter-flush 4] [--shutter-only <场景id,场景id>] [--motion-hold 1] [--preview 30] [--keep-frames] [--only <场景id>] [--mux-only] [--png-fast|--jpeg --jpeg-quality 95] [--workers N] [--concurrency N] [--resume] # 渲染:out/<slug>.mp4(★ 通道/档位先按确认点 5 问过用户;★ 通道与档位必须一起报——`--jpeg` 与默认快门同时用,中间帧扩展名要一路贯穿到积分器;★ 快门覆盖面也要问:全片开还是 `--shutter-only` 点名几场)
"$PY" <skill>/scripts/qc_check.py --project . # 体检 + 抽帧速览图
node <skill>/scripts/cover_build.mjs . # 封面:out/cover_169.png + cover_34.png(竖版再加 cover_916.png)
node <skill>/scripts/check_cover.mjs . # 封面终态几何实测:边距/钩子字号/行宽/孤字/文字重叠/9:16 禁两栏(FAIL 清零再交)
```
配音引擎(**跑之前必须先问用户**,见确认点 3):`edge`(默认,免费免密钥)或
`volcano`(火山引擎语音合成 2.0,音质更好,需 API Key)。两者产出的 manifest 结构一致,
下游零改动。切换:`--provider edge|volcano` 或 `TTS_PROVIDER` 环境变量。
**火山密钥只存 `tts.env`(已 gitignore)—— agent 只调 `tts_volcano.py`,不读该文件。**
详见 `references/volcano-tts.md`。
### ★ 确认点 5 —— 渲染通道:**动手渲染前必须问用户选哪条,不许默认开工**
**硬规则:任何一次真正的渲染(打样 / 全片 / 局部补渲)之前,先把下表摆给用户让他挑通道。
不许凭「上次用的 png-fast」或「PNG 是默认」就静默开工。** 用户在打样阶段选定后,
同一轮的重复渲染可沿用;**换通道或换档位要重新确认一次**。
| 通道 | 参数 | 相对速度(纯 CSS 图形帧并行 / 满幅照片帧) | 画质(客观口径) | 中间帧体积(1080p · 纯图形帧实测) | 定位 |
|---|---|---|---|---|---|
| **PNG-fast** ★**默认推荐** | `--png-fast` | **×1.02 / ×4.4** | 逐像素无损(PSNR 99 dB、最大差 0) | **0.10 MB/帧**(8525 帧 ≈ **0.85 GB**) | 纯 CSS/MG 图形帧上**与 JPEG q95 同速、体积更小、还是无损** → 默认就用它 |
| **JPEG q95** | `--jpeg --jpeg-quality 95` | ×1.00 / **×13** | PSNR **41.65 dB**,低于 x264 crf18 成片自身失真 | 0.12 MB/帧 | **含满幅照片 / 重合成帧、或 4K 终稿**时的首选(照片帧上 PNG 是 582ms/帧的黑洞) |
| **PNG**(1.4.x 默认) | 不带开关 | ×1.16 / ×1.0(基准) | 逐像素无损 | 0.08 MB/帧 | 仅 `--profile legacy` 逐位复现旧成片、或 `master` 极限档 |
| **JPEG q82** | `--jpeg --jpeg-quality 82` | 最快 | 略低于 q95,仍高于多数成片编码失真 | ~0.08 MB/帧 | 只做打样/迭代预览,不用于交付 |
> **体积口径提醒**:上表体积是**纯 CSS/MG 图形帧**(大面积平色 + 文字)实测。同一批通道在
> **满幅照片 / 重合成帧**上会整体抬高一到两个数量级(精细 PNG 单帧可达 1.6–2.0 MB),
> 表格里的相对关系不变,但绝对量级不可直接套用。
**为什么默认改成 PNG-fast(2026-10-05 口径修订)**:原表把 JPEG q95 列为默认推荐,
依据是「×13 编码速度」—— 但那组倍率测的是**满幅照片帧**。本技能绝大多数片子是
**纯 CSS/MG 图形帧**,PNG 的 deflate 对平色块极其高效,本机 6 进程并行实测:
| 通道 | 吞吐 | 相对 | 体积 |
|---|---|---|---|
| JPEG q95 | 27.14 帧/秒 | ×1.00 | 0.12 MB/帧 |
| **PNG-fast** | **26.65 帧/秒** | **×1.02** | **0.10 MB/帧** |
| PNG 精细 | 23.41 帧/秒 | ×1.16 | 0.08 MB/帧 |
→ **纯图形帧上 PNG-fast 与 JPEG q95 基本同速、体积更小、且逐像素无损**,默认场景下全面占优。
而「**JPEG q95 不是降质**」这句依然成立:中间帧还要再被 x264 压一次,q95 的 PSNR 41.65 dB
低于 crf18 成片自身失真,所以它在**照片帧 / 4K 终稿**里依旧是对的默认。
**怎么问(照抄这句,四条都要列全 —— 这是硬要求)**:
> 渲染通道你要哪条?質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。