vibe-explainer
/vibe-explainer
Tworzy krótkie filmy edukacyjne bez narracji, rysowane kodem klatka po klatce, z jednym wierszem napisów i dźwiękiem efektów.
- Autor
- blakeguo7 ↗
- Repozytorium
- vibe-explainer ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy krótkie filmy edukacyjne bez narracji, rysowane kodem klatka po klatce, z jednym wierszem napisów i dźwiękiem efektów.
Wyzwalacze z opisu
Oryginalny opis (EN)
做没有旁白的知识讲解短片:观众读底部一行字幕,同时看屏上把这句话演出来;全片用代码逐帧画出(Canvas + Playwright + ffmpeg),声音只有音效。 外观和时长都不预设:每条片按题材、语气、屏上的主体和观看方式现推一张外观卡,横屏竖屏都行;时长按分镜表的句数算出来。 用户说"做一条讲 X 的视频""把这个知识点做成动画""做个 vibe 视频""没有旁白的字幕科普片""代码画出来的讲解片""把我的笔记做成视频""把这个概念直观地讲清楚", 或者给了一个题目、一份文案、一份学习笔记想做成这种片子时,都用这个 skill,即使用户没说"vibe"。 有人声口播的视频、剪辑现成素材、做 PPT 不用这个。
Jak działa
- 底线:不管什么外观都不变
- 外观:按内容推出来
- 时长:按内容算
- 流程
- 看图改图
- 文件
Podgląd SKILL.md
--- name: vibe-explainer description: > 做没有旁白的知识讲解短片:观众读底部一行字幕,同时看屏上把这句话演出来;全片用代码逐帧画出(Canvas + Playwright + ffmpeg),声音只有音效。 外观和时长都不预设:每条片按题材、语气、屏上的主体和观看方式现推一张外观卡,横屏竖屏都行;时长按分镜表的句数算出来。 用户说"做一条讲 X 的视频""把这个知识点做成动画""做个 vibe 视频""没有旁白的字幕科普片""代码画出来的讲解片""把我的笔记做成视频""把这个概念直观地讲清楚", 或者给了一个题目、一份文案、一份学习笔记想做成这种片子时,都用这个 skill,即使用户没说"vibe"。 有人声口播的视频、剪辑现成素材、做 PPT 不用这个。 --- # Vibe 讲解片 一种没有旁白的知识讲解片:观众读底部的一行字幕,同时看屏上把这句话**演出来**。 片子好不好,看的是观众能不能一眼认出屏上的东西、看见它在变、看完讲得出"因为……所以……"。 屏上的东西换给任何一段文案都成立的,是配图,不是讲解(例子见 `references/explain.md` 第一节)。 交付物:一个工程目录,里面有外观卡 `look.md`、分镜表 `storyboard.md`、`film.js` 和成片 `renders/final.mp4`;再加一张事实表。 ## 底线:不管什么外观都不变 1. **先找形象,再写文案。** 每个概念先找一样外行认得的东西来演它;画不出来的句子,改句子。 2. **屏上的主体叫得出日常名字,长得像它本身。** 点、线、圈、柱子、方框不算;一个方框加一个标签也不算。 3. **句子里的动词,屏上真的做。** 数是算出来的;示意的地方写明"示意"。 4. **先例子,后道理。** 名字、公式、结论排在例子之后;开头几秒先让观众看见一件事,再出片名。 5. **该画的画,该停的停。** 提问、命名、结论、引文不配新画面,把上一幕停住,让观众想一想。 6. **一个形象、一把尺子用到底。** 一个场景撑两句以上,每句只改一处;结尾回到开头的画面。 7. **画面现写,不套模板。** `examples/` 和 `looks/` 是看做法的,不是零件库。 8. **没有人声,没有配乐,每个事实带出处。** 声音只用跟着画面事件走的音效:看得见的动作配一声轻的,关键的那一下配重的。 9. **画面底线。** 字幕区只放字幕;任何一刻只有一个主体在动;每种颜色全片一个意思;缩到手机大小还看得清。 10. **字幕是地道的中文讲解。** 像一个讲得好的中文老师当面在讲:一句接着一句,因果说出来,不跳步;说中国人平时说的话,不写电报体,不写翻译腔(写法见 `references/script.md` 第三节)。 ## 外观:按内容推出来 不从模板里挑。回答四个问题,推出一张外观卡(详见 `references/look.md`): 1. **题材是什么性质?** 抽象概念、技术系统、生活和心理、历史、自然和身体。决定底和画法。 2. **语气是什么?** 冷静、好奇、温暖、紧张、幽默。决定颜色的温度、节奏和音色。 3. **屏上的主体主要是什么?** 字和符号、机器和图表、有体积的实物、场景和角色。决定字体和辉光。 4. **观众在哪看?** 横屏还是竖屏。决定画幅、字号和字幕位置。 外观卡写进工程的 `look.md`,代码里的 `LOOK` 全部照它填;改外观先改卡。`looks/` 里有三张推好的卡可以对照。 ## 时长:按内容算 不设上下限,也不先定时长。分镜表写完,跑 `python scripts/estimate.py <工程目录> --hold 每句停留秒数` 估出来。 一个概念演透通常要 3–10 句;只讲一件事,几十秒就够;讲五六个侧面,五分钟以上也正常。 不为凑时长加内容,也不为压时长把道理塞进几句话;算出来很长时,问用户要一条长片还是拆成几集。结构怎么跟着长度变,见 `references/script.md` 第一、二节。 ## 流程 每一步后面是过关标准,没过就停在这一步改。一共三次给用户看:形象方案、分镜表加外观卡、样片。 用户说"直接做"时,确认可以不等,但东西照样要写出来。力气不够时也不跳步,宁可少讲两个概念:每一镜都认得出,比多讲两个概念重要。 命令里的 `scripts/`、`engine/` 指本 skill 目录下的路径;工程目录建在用户自己的项目里,不建在 skill 目录里。 ### 0. 看清手里有什么 - **只有题目**:从第 1 步做起。 - **有文案**:照样过第 1、2 步;画不出来的句子要改,保留原意和事实,改完告诉用户改了哪些。 - **有学习笔记**(比如一个 Notion 页面):先读完,按 `references/script.md` 第四节挑出能演的几个点,再从第 1 步做起。 - **有一版做坏的片子**:先截帧对着字幕看,找出毛病,再重做同一段内容。 ### 1. 立题和事实表 写下:片名;一句话论点;概念清单,每个概念写"要观众明白什么"和"外行卡在哪";事实表,写每个年份、人名、数字的出处和把握程度。把握不足的去查,查不到就换例子。 片名讲什么就叫什么:讲 MySQL 架构,片名就是"MySQL 架构"。不另起比喻或意象式的名字,比喻留在片子里演(见 `references/script.md` 第五节)。 过关:片名一眼看得出讲什么;论点一口气说得完;每个概念能不用术语讲给外行听。讲不出来的,先去把它弄懂。 ### 2. 找形象 照 `references/explain.md` 第四节,给每个概念找一个外行认得的形象;定全片的那一个形象、那一把尺子,和哪些东西会回场。 过关:每个形象叫得出日常名字,换给别的文案不成立;至少一半的概念找到了生活里的锚;说得出全片哪一下最让人"哦——"。 **第一次给用户看**:形象方案,钩子给三个方向和一个推荐。 ### 3. 分镜表和时长 建工程,文案和分镜表一起写进 `storyboard.md`(格式和自查见 `references/explain.md` 第五节,字幕写法见 `references/script.md`),再估时长: ```bash python scripts/new_film.py <工程目录> --canvas 16:9 # 竖屏写 9:16 python scripts/estimate.py <工程目录> --hold 4 ``` 过关:遮住字幕一列,只读"屏上是什么、在干什么",看得出在讲什么;反过来只读字幕一列、念出声,像一个中文老师在当面讲,句句接得上,没有跳步和拗口的句子;"不画"的大约占五分之一;每一镜过得了三问(这是什么、它在干什么、观众明白了什么)。**没有分镜表,不写画面代码。** ### 4. 推外观 照 `references/look.md` 写外观卡 `look.md`,把它填进 `film.js` 的 `LOOK`,做一张样帧(钩子里最典型的一镜): ```bash python engine/render.py <工程目录> --stills 3 ``` 过关:外观卡里每一项都说得出为什么这样选;样帧遮住字幕认得出主体、缩到手机大小字读得清。 **第二次给用户看**:分镜表、估出的时长、外观卡和样帧一起。 ### 5. 先做最难的一镜 照分镜表把**最难画的那一镜**做出来,截图,按下面"看图改图"改。引擎用法在 `references/engine.md`。 过关:遮住字幕和小字,答得出"这是什么、它在干什么"。第一版几乎不会过,改两三轮是正常的;答不出来就回第 2 步换形象。 ### 6. 样片 全片超过 30 秒的,先做前 30 秒;不到 30 秒的,直接做全片。景别要变:全景交代在哪,中景看它做什么,近景看关键的那一下;同一个固定画面不撑过三四句。 ```bash python engine/render.py <工程目录> --motion 8 10.5 # 每个转场前后抽帧看一遍 python engine/render.py <工程目录> --clip 0 30 head ``` 过关:字幕出现后 0.3 秒内屏上有动作;"哦——"之前有铺垫、之后停得住;场景之间是推过去或者长出来的,不是硬切。**第三次给用户看。** ### 7. 铺全片 一个概念一个函数;长片按章拆文件。每做完两三个概念,拼图自查一次:有没有东西伸进字幕区,有没有两样东西同时抢着动,该回场的东西回来了没有。 ```bash python engine/render.py <工程目录> --sheet 16 python engine/render.py <工程目录> --check ``` ### 8. 声音 只有音效,不垫配乐、不垫长音,也不向用户要配乐。在 `film.js` 的 `SFX` 表里登记,分轻重两层: - **重音**:这一镜最关键的那一下(落地、断开、报错、揭晓),用 `thud` `stamp` `reveal` 这类;片名和章节开头一记短钟声 `chime`。 - **轻音**:画面里看得见的小动作,大多配一声轻的:卡片落位、一层层往下走、面板滑出来、打字、计数到头。用 `tap` `blip` `slide` `keys` `tick`,音量压低(`gain` 0.4–0.8)。 同一串动作用同一种轻音打出节奏,比如往下走三层就是三声 `blip`,音高依次往下。 大约每 3–5 秒有一声,画面在动的时候不冷场;但不要密到一秒一声:轻音离上一声不到 1.5 秒的,`audio.py` 合成时会自动去掉,`--check` 也会提前报出这些地方。 一串有节奏的动作(一路扫过去、一格格亮起)要全留,就在选项里写 `keep: 1`。打字配一串 `keys`,不是一个字一声。 镜头推拉、字幕出现不配;提问那一句停住时留安静,这一下安静本身就是停顿。音色跟着外观卡走。 ### 9. 渲染和终检 ```bash python engine/render.py <工程目录> --check python engine/render.py <工程目录> --jobs 4 python engine/render.py <工程目录> --events && python engine/audio.py <工程目录> ``` 渲完先静音、遮住字幕看一遍,再只读字幕、念出声一遍,然后开着声音看一遍(声音冷不冷场、吵不吵),最后对照 `references/review.md` 第三节的终检表。不合格的段落只重渲那一段(`--clip`),确认后再渲全片。 交片时说实话:还不满意的地方、没做的东西、没完整看过的部分,直接列出来。 ## 看图改图 第一次渲出来的画面几乎都有毛病,这种片子是看着图改出来的。第 4 步起,每做完一镜就截图看:看图,不看代码;遮住字幕和小字过三问。 对照 `references/review.md` 的毛病表改,每一轮改完重截同样的时刻,确认改掉了、没改坏别的。至少改两轮再给用户看。 ## 文件 | | | |---|---| | `references/explain.md` | 讲解设计:讲解和配图的区别、六种演法、每类句子怎么演、怎么找形象、分镜表格式和例子 | | `references/script.md` | 字幕:时长怎么估、几种结构、句式、从笔记改写、事实和片名 | | `references/look.md` | 外观:画面底线、四个问题怎么推外观、外观卡模板、我们常做的题材 | | `references/review.md` | 质检:三问、毛病表、终检表、自动检查 | | `references/engine.md` | 引擎:命令、`film.js` 的写法、外观卡怎么变成代码、画面对象的用法、坑 | | `looks/` | 三张推好的外观卡:暗场仪器、蓝图、纸面 | | `engine/` | `ve.js` 引擎、`render.py` 渲染和检查、`audio.py` 音效、`get_fonts.py` 字体 | | `scripts/` | `new_film.py` 建工程、`estimate.py` 估时长 | | `examples/` | 我们自己做的例子,说明在 `examples/README.md` |
Pliki w paczce (5)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 3 KB
- SKILL.md 11 KB
- requirements.txt 1 KB
Wersje
W bazie nie ma innych skilli o nazwie vibe-explainer.
Migawka bazy z 13.11.2026 · wersja paczki c882b1e47625 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95vibe-knowledge-film
Tworzy bezgłosowy film edukacyjny 16:9 z napisami, w którym ekran pokazuje to, o czym mówi zdanie, a obrazy rysuje kod. - 100vibe-knowledge-studio
Tworzy bezgłosowe krótkie filmy edukacyjne w stylu Vibe: animacje kodem, dwujęzyczne napisy, muzykę i okładkę mp4. - 100vibe-skill-audit
Tworzy, poprawia i audytuje lokalne skille Vibe w repozytorium, opakowując skill-creator pod kątem projektu. - 95vibe-knowledge-video
Tworzy dopracowane filmy edukacyjne po chińsku w Remotion na podstawie tematu lub materiału: scenariusz, narrację, napisy, muzykę i MP4. - 100vibe-knowledge-film-ledomit
Projektuje bezgłosowe filmy wiedzy 16:9 z animacją kodu, z opisem sposobów rysowania, wyglądów i pacing sceny po scenie. - 100interactive-explainer
Tworzy edukacyjne wideo wyjaśniające z prowadzącym i postaciami, np. krótkie formy historyczne lub naukowe z dialogami zamiast samego lektora.