Skip to content
Back to search

bio-viz-film

SkillWorks with Claude CodeGitHub

把细胞生物学、病毒学、分子生物学的知识点(课本章节、论文模型图、实验过程)做成教授级、可商用的 3D 讲解视频:three.js 程序化剖面场景 + 电影级渲染(景深、辉光、烘焙 AO),按"步骤"演示真实过程(如分泌蛋白合成与运输、胞吐、病毒入侵)。可直出纯画面视频(无文字),或带原创讲解版式(步骤标题、课本原句、通路导航、图例、出处)。内置科学准确性流程:事实表带出处 → 禁止画面清单 → 两轮独立审查(科学 + 画面)。用户说"做个细胞/病毒/细胞器动画""把这章课本做成动画""论文/答辩/教学用的生物 3D 视频""分泌蛋白/胞吐/有丝分裂/病毒入侵动画"时使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/moluyao--bio-viz-film/badge.svg)](/listings/moluyao--bio-viz-film)

HTML

<a href="/listings/moluyao--bio-viz-film"><img src="/api/listings/moluyao--bio-viz-film/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# as a Claude Code skill
git clone https://github.com/moluyao/bio-viz-film ~/.claude/skills/bio-viz-film

# render the example (needs Chrome + ffmpeg)
cd ~/.claude/skills/bio-viz-film/template/tools && npm install
cd .. 
node tools/record.mjs site2 out/lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080
node tools/record.mjs site2 out/clean.mp4   --size 1920x1080 --dpr 2 --scale 1920x1080 --query layout=clean
# preview live: serve template/site2 with any static server and open index.html (space = pause)

Then just ask Claude: *"Turn textbook section X into a 3D explainer"*, *"animate viral entry for my thesis defense"*, *"make a clean 3D clip of exocytosis"*.

The skill's working docs (`SKILL.md`, `references/`) are written in Chinese; Claude reads them fine in any language and will answer in yours.

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 · 125 lines
  1. ---
  2. name: bio-viz-film
  3. description: 把细胞生物学、病毒学、分子生物学的知识点(课本章节、论文模型图、实验过程)做成教授级、可商用的 3D 讲解视频:three.js 程序化剖面场景 + 电影级渲染(景深、辉光、烘焙 AO),按"步骤"演示真实过程(如分泌蛋白合成与运输、胞吐、病毒入侵)。可直出纯画面视频(无文字),或带原创讲解版式(步骤标题、课本原句、通路导航、图例、出处)。内置科学准确性流程:事实表带出处 → 禁止画面清单 → 两轮独立审查(科学 + 画面)。用户说"做个细胞/病毒/细胞器动画""把这章课本做成动画""论文/答辩/教学用的生物 3D 视频""分泌蛋白/胞吐/有丝分裂/病毒入侵动画"时使用。
  4. ---
  5. # bio-viz-film · 生物 3D 讲解片(v2)
  6. 目标:**教授看了挑不出错,学生看了一遍就懂,画面达到商用水准**。准确性优先于好看;不编数据、不编过程。
  7. ## 目录
  8. ```
  9. template/site2/ ← 当前引擎(v2)
  10. index.html 讲解版式(原创:深色学术风,衬线标题,右侧通路导航)
  11. engine.js 渲染器、相机、时间线、后期(景深 + 辉光),讲解叠层
  12. lib.js 种子随机、实例化构建、动态池、烘焙 AO
  13. scene-*.js 程序化场景,导出 build(scene, seed) → { anchors, update(t,T), palette }
  14. story-*.js 故事脚本:步骤、镜头、字幕、过程时间窗、图例、出处
  15. vendor/ three r170 + addons(postprocessing / environments 等)
  16. template/site/ ← v1 旧引擎(仪表盘风格,细胞/病毒;已知科学问题见 references/pitfalls.md,不建议再用)
  17. template/tools/ record.mjs 逐帧录制 · sheet2.py 样张拼图 · probe.mjs 射线探针 · hidetest.mjs 逐物体排查
  18. references/ accuracy-protocol.md(必读) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
  19. examples/ secretion:人教版必修1 3.2《分泌蛋白的合成和运输》完整示例 + 五轮审查记录
  20. ```
  21. ## 输出形态(版式可选)
  22. | `?layout=` | 效果 | 适合 |
  23. |---|---|---|
  24. | `clean` | **纯 3D 画面,没有任何网页或文字** | 二次剪辑、配音、做背景 |
  25. | `lecture`(默认) | 深色学术版:步骤序号 + 衬线标题 + 课本原句、右侧通路导航、图例、底栏出处 | 讲解视频、发布 |
  26. | `notes` | 浅色讲义版:左侧 3D 圆角画框,右侧纸面列出全部步骤(当前步展开原句)、图例、实验数据、出处 | 课件、上课投屏 |
  27. | `dashboard` | 追踪仪表盘:右侧面板实时显示标记分子在各区室的个数(来自模型本身的计数,并注明不是实验值) | 科研汇报、演示"过程" |
  28. | `bench` | **浅色实验台网页**(对标爆款的仪表盘风):顶栏(视场、步骤、模型时钟)+ 跑马灯真知识 + 带框 3D 窗口(标签用十字准星钉在 3D 结构上、实时比例尺)+ 模型计数条 + 步骤条 + 三张小图卡(典型值曲线 / 模型计数曲线 / 课本示意)。竖版 1080×1350 最佳 | 发推特、小红书的网页版 |
  29. | 自定义 | 在 `layouts/` 新建 `<名字>.js`,导出 `meta / css / html / mount / update` 四项,用 `?layout=<名字>` 调用 | 按主题或按要求定制 |
  30. - story 里可以写 `layout: 'notes'` 设默认版式;`--size 1080x1920` 出竖版,各版式自动换成竖排布局。
  31. - 新版式规则:
  32. - 画面上的每个数字都必须是真实的(来自出处或模型状态);
  33. - 不照抄参考视频,版式要按主题新设计;
  34. - 3D 主体用 `meta.camShift` 让出文字区。
  35. ## 炫片模式(Showreel)—— 要流量、要惊艳时用
  36. 和讲解版用同一套科学内容,只改"怎么展示"。可以在提示词里直接说,也可以用参数:
  37. | 你可以说 | 参数 | 可选值 |
  38. |---|---|---|
  39. | "做个炫片 / 惊艳版 / 竖版短视频" | `?story=<题材>-reel`(讲解 story 按 0.42 倍压缩时间,一镜到底) | — |
  40. | "风格明亮 / 霓虹 / 学术 / 纸质" | `look=` | `vivid` 明亮糖果 · `neon` 暗底霓虹发光 · `academic` 深色学术 · `paper` 纸面 |
  41. | "配色换成糖果 / 冰蓝 / 日落" | `palette=` | `textbook` · `candy` · `ice` · `sunset` · `neon` |
  42. | "要那种扫描换色的转场" | `fx=channels` | 每到新一步,用像素扫描带切换到下一个"伪彩通道"(类似荧光显微镜切换通道) |
  43. | "大字标题 / 抖音风" | `layout=reel` | 每步一句大字钩子,加伪彩通道标签和简短免责 |
  44. | "竖版" | `--size 1080x1920` | 竖版时相机自动拉远 1.7 倍(`portraitZoom`) |
  45. 规则:
  46. - 伪彩只换颜色,不改结构和过程;画面上必须常驻"颜色为伪彩"的说明。
  47. - 炫片版同样要经过科学审查。
  48. 录制:
  49. ```
  50. node tools/record.mjs site2 out/x_clean.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion&layout=clean"
  51. node tools/record.mjs site2 out/x_lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion"
  52. ```
  53. `--draft`(1 倍、30fps,约 1/8 时间)先出预览档给用户确认,再录正片。录制器会加锁防止两个进程同时写同一个文件;先写 `*.partial.mp4`,完成后才改名;最后自动逐帧解码校验,有错误就报出来。
  54. `--dpr 2 --scale 1920x1080` 的意思是:先按 2 倍分辨率渲染,再缩回 1080p,相当于超采样抗锯齿。要 4K 成片就去掉 `--scale`。
  55. ## 流程(每一步都不能跳过)
  56. **1. 事实表(先于画面)** —— 按 `references/accuracy-protocol.md` 执行
  57. - 课本题材:先找到课本原句,用作字幕主干;字幕只写课本层级的结论,大学层级的细节放进事实表备注。
  58. - 论文题材:从摘要和图注中提取论点,每个镜头对应一个 Figure,标注写出处(例如 Fig.2b)。
  59. - 产出:`review/事实表.md`,列为 步骤 | 字幕原句 | 依据(课本节/DOI)| 状态(已核/待核)。待核的内容不能上屏。
  60. - 同时写出**禁止画面清单**,列出这个主题的常见错误(例如"核糖体进入内质网腔""蛋白质裸露在细胞质中漂移")。
  61. **2. 第一轮独立审查(事实表 + 场景设计)**:起一个子智能体,只给它事实表、故事脚本和场景说明,要求它逐条挑错。
  62. **3. 写场景与故事**:见 `references/new-scene.md`。
  63. - 每个过程都写成 t 的纯函数(例如 `update(t, T)`),时间窗统一放在 story 的 `T` 里。
  64. - 被追踪的分子用发光材质表示,其他分子用暗色材质,画面上的"标记"含义要和实验一致。
  65. - 大小只保留相对顺序,并在画面上写明"非真实比例"。时间压缩也要写明。
  66. **4. 样张自检**:用 `--stills` 出每一步的中间帧,拼成拼图检查:关键事件在不在画面中心、看不看得清,结构有没有穿插或空洞。
  67. - 发现可疑的暗块或空洞,用 `probe.mjs`(射线探针)和 `hidetest.mjs`(逐个隐藏物体)定位,不要靠猜。
  68. **5. 第二轮独立审查(成片样张)**:子智能体扮演"细胞生物学教授 + 科普片美术总监",审样张、字幕和过程代码,给出必须改的清单和"能否直接用于教学"的结论。
  69. - 只有改完所有"错误"和"误导"级的问题,才能出片。
  70. **6. 出片与交付**:
  71. - 交付物:纯画面版 + 讲解版两条 mp4,加上事实表和两轮审查记录。
  72. - 发布时附中英文文案;不混 BGM。
  73. ## 网页版(bench)要点
  74. - story 里写 `layout: 'bench'`,并提供 `brand / title / sub / notes(跑马灯,必须是有出处的事实)/ clock(胶片秒→生理毫秒)/ conv(每步高亮哪种信号)`,每步写 `chip / badge / call(标注:锚点、标题、副标题、要点)`。
  75. - 页面上的数字只允许三种来源,并在卡片角标注明:`MODEL`(场景 census 计数)、`TYPICAL`(教科书典型值)、`TEXTBOOK`。比例尺和视场由相机实时算。不要写 LIVE / 实时显微之类会被误认为真实数据的字样。
  76. - 模型时钟要和字幕、曲线一致;放慢倍数写真实范围(非线性就写非线性)。
  77. ## 近景"切片模式"与膜厚度
  78. - `STORY.slab(t)`:第二个全局裁剪面(只保留 z ≥ 值),近景时把场景切成约 50–100 nm 厚的切片,像电镜切片一样干净。
  79. - 膜用 `shell()` 做成有厚度的闭合双层(外层朝外、内层朝内,5 nm),材质 `capify`,切口显示成实心色带;关键事件(融合孔、内吞小窝)放在剖切面上,相机接近正俯视,Ω 形轮廓才看得清。
  80. - 远景里分子/离子按相机距离放大显示(`__camDist`),页脚注明"远景分子放大"。
  81. ## 两条出片路线(详见 references/two-routes.md)
  82. - **快速路线**:three.js 实时渲染(加 N8AO 环境光遮蔽),49 秒的片子约 15 分钟出完,用于迭代和日常出片。
  83. - **专业路线**:`export_blender.mjs` 导出场景 → `blender_build.py` 在 Blender 里重建,用 Cycles 路径追踪渲染 → `record.mjs --overlay-dir` 生成网页界面层,再叠加上去。本机约 17–20 秒/帧,用于最终发布版。
  84. - 同一时间只能跑一个 Blender 任务,两个会内存不足、直接崩溃。
  85. ## 分子级"珠串风格"(不简化:用真实结构)
  86. - `tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group 链]`:把真实的原子结构变成珠子模型。膜蛋白加 `--opm`,用 OPM 数据库的膜内定向。
  87. - 场景顶层 `await fetch('./mol/*.json')`,用 `beadGeo()` 生成几何。剖切面以上的珠子整颗丢掉,不留半个空壳。
  88. - 摆放时做珠子级碰撞检测,保证 0 穿模;`node tools/check.mjs site2 "story=..."` 复查。
  89. - 计数要按化学计量自洽(例:1 个 O₂ 对应 PSII 吸收 4 个光子、PSI 吸收 4 个光子,传递 4 个电子,类囊体腔进 12 个 H⁺,生成 2 个 NADPH,约 2.6 个 ATP)。示意性的连续动画要单独标注 ILLUSTRATIVE。
  90. ## 形态原则(不简化)
  91. - 细胞器**按电镜真实形态和比例**建模,不画成规整几何体。尺寸先查表(`references/morphology-acinar.md` 的写法),再写代码。
  92. - 跨三个数量级(细胞 15 μm → 核糖体 25 nm)时不缩放结构,而是让相机连续推近(对数距离插值),分子事件放在近景里看。
  93. - 闭合结构(颗粒、线粒体、浓缩泡、核)被剖切时显示实心截面(`capify`),不留空壳。
  94. ## 版式原则
  95. - 版式按主题原创,不照抄参考视频。
  96. - 默认风格是深色学术风:衬线标题,正文为课本原句,用一种强调色(等于示踪物颜色)。
  97. - 画面上出现的每一个数字都必须有出处。不用假仪表盘、假计数、假曲线。
  98. - 引用和免责声明常驻底栏:示意动画 · 非真实比例 · 时间已压缩 · 出处。
  99. ## 已完成示例
  100. - `thylakoid`:叶绿体 → 基粒 → 类囊体膜上的光反应,9 种真实蛋白结构(PSII-LHCII、b₆f、PSI、ATP 合酶、LHCII、PC、Fd、FNR、Rubisco),英文 bench 网页版 `story=thylakoid-en`,快速和专业两条路线都出过片。
  101. - `synapse`:海马谷氨酸能突触(轴突串珠 → 蘑菇状树突棘),真实比例 1 单位 = 20 nm,动作电位 → Ca²⁺ 内流 → 单个小泡完全塌陷融合 → ~4,000 谷氨酸扩散 → AMPA 开放、Na⁺ 内流 → 星形胶质摄取 → 网格蛋白内吞与再装填。英文 bench 网页版 `story=synapse-en`,约 50 秒。事实表与审查见 `examples/synapse/`。
  102. - `secretion`:豚鼠胰腺腺泡细胞,分泌蛋白从游离核糖体到胞吐的全过程,约 75 秒,共 9 步,含 ³H-亮氨酸实验的时间线(3/17/117 min,课本数据)。
README.md · README · 130 lines
  1. **English** · [中文](README.zh-CN.md)
  2. # bio-viz-film
  3. **A Claude Code skill for making professor-grade 3D biology explainer videos from code — with a built-in accuracy protocol so the animation never invents science.**
  4. ![preview](examples/secretion/media/preview.gif)
  5. Give it a textbook section, a paper figure, or a process ("secretory pathway", "exocytosis", "viral entry"). It builds a procedural cutaway cell in three.js, animates the *real* process as a pure function of time, and records it frame-by-frame into a deterministic 1080p/4K video:
  6. Pick a layout per video (`?layout=`):
  7. | layout | what you get |
  8. |---|---|
  9. | `clean` | pure 3D footage, no page or text at all — for your own voice-over / editing |
  10. | `lecture` (default) | dark academic layout: step number + serif title, textbook-wording captions, pathway navigator, legend, sources |
  11. | `reel` | Showreel: one bold hook per step, legend, "pseudo-colour" chip — vertical-feed friendly |
  12. | `notes` | light "handout" layout: 3D on the left, every step listed on a paper sidebar — for courseware |
  13. | `dashboard` | live tracking panel: how many labeled molecules sit in each compartment, counted from the model itself (and labeled as such) |
  14. | your own | drop a `layouts/<name>.js` (meta / css / html / mount / update) and design it for the topic |
  15. ## v4: real protein structures, two render routes (new)
  16. <p><img src="examples/thylakoid/media/cover_h.jpg" width="62%"> <img src="examples/thylakoid/media/cover_v.jpg" width="30%"></p>
  17. New case: **the light reactions of photosynthesis on the thylakoid membrane** (high-school textbook level, English on-screen text).
  18. | | |
  19. |---|---|
  20. | Pro route (Blender Cycles, path-traced) | [`thylakoid_pro_720p.mp4`](examples/thylakoid/media/thylakoid_pro_720p.mp4) |
  21. | Quick route vs Pro route, side by side | [`thylakoid_quick_vs_pro_720p.mp4`](examples/thylakoid/media/thylakoid_quick_vs_pro_720p.mp4) |
  22. | 1080p masters (with soundtrack) | [Release v4.0](https://github.com/moluyao/bio-viz-film/releases/tag/v4.0) |
  23. - **Every protein is a real atomic structure.** `tools/pdb2beads.py` downloads PDB/mmCIF (RCSB), or the membrane-oriented version from the **OPM** database, and coarse-grains it into 0.6 / 1.4 nm beads, with chlorophyll, carotenoid and metal clusters coloured by class. It also exports key sites (Mn cluster, quinone sites, hemes, Fe–S clusters) so the process animation starts from the real positions. The film uses 9 structures: PSII–LHCII, b₆f, PSI, ATP synthase (rotor chains tagged so the c₁₄ ring really turns), LHCII, plastocyanin, ferredoxin, FNR and Rubisco.
  24. - **Zero intersections, checked:** placement uses a bead-level collision grid, and `tools/check.mjs` re-checks every bead of every molecule (2,459 molecules → 0 overlapping pairs).
  25. - **Two routes, one scene:**
  26. - **Quick route:** three.js + N8AO ambient occlusion, about 15 min for a 49 s film.
  27. - **Pro route:** the same scene is exported (`tools/export_blender.mjs`), rebuilt in Blender with geometry nodes and Cycles point clouds (`tools/blender_build.py`), path-traced with GPU denoising, and the web dashboard is composited back on top (`record.mjs --overlay-dir`). It runs at about 4 s/frame on a laptop iGPU after tuning: GPU-only, denoise on the GPU. See `references/two-routes.md`.
  28. - **New layout `bench`:** a light "lab instrument" page with a framed live 3D window, reticle callouts pinned to 3D anchors, a scale bar measured from the camera, model counters, and cards tagged MODEL / TYPICAL / TEXTBOOK. Every number on the page has a stated origin.
  29. - **Science review:** an independent review found inconsistent counters and pH timing; both were fixed. The counters now follow one O₂ worth of stoichiometry: 8 photons, 4 e⁻, 12 H⁺, 2 NADPH, ~2.6 ATP.
  30. - Also new: a chemical-synapse case (`scene-synapse.js`, bench layout), original synthesized soundtracks timed to each film's events (`tools/bgm_*.py`), and an NPU (OpenVINO) feasibility test for AI frame interpolation (it runs, but the quality wasn't good enough, so it isn't used).
  31. ## v3: true proportions + Showreel mode
  32. - **No simplified organelles.** Every structure follows EM data at true proportions (1 unit = 0.5 µm): pyramidal acinar cells forming an acinus, 16 parallel RER cisternae studded with 25 nm ribosomes, 6-cisterna Golgi stacks with dilated fenestrated rims, condensing vacuoles (Ø ~1.5 µm) maturing into ~0.9 µm zymogen granules, cristae-filled mitochondria, 100 nm microvilli. The camera zooms continuously over three orders of magnitude instead of rescaling anything. Dimension table: `references/morphology-acinar.md`.
  33. - **Showreel mode** for the scroll-stopping version of the same science: `look=vivid|neon|academic|paper`, `palette=candy|sunset|neon|textbook`, `fx=channels` (pixel-scan wipe to the next pseudo-colour palette), `layout=reel` (one bold hook per step + legend + "pseudo-colour, not microscopy" chip), vertical 1080×1920. Ask in plain words: *"make a bright, punchy vertical reel of this"*.
  34. - Five independent review rounds so far; the latest verdicts: lecture cut usable for teaching, showreel fixed after round 5 (legend colour clashes, overexposed fusion shot, a stray fragment).
  35. ## Why another bio-viz tool
  36. Most AI-made "science" animations look great and are quietly wrong: fake dashboards, made-up numbers, ribosomes swimming into the ER, proteins floating naked through the cytoplasm. This skill treats accuracy as the first requirement:
  37. 1. **Fact sheet first** — every caption and number gets a source (textbook section / DOI). Unverified → not on screen.
  38. 2. **Forbidden-shots list** — the known misconceptions for the topic, written down before any animation.
  39. 3. **Two independent reviews** — a fresh sub-agent plays *cell-biology professor + science-film art director*, reviews stills, captions and the process code, and must answer "usable for teaching: yes / no".
  40. 4. **Fix everything rated "error" or "misleading", re-review, then render.**
  41. No fake data panels, no ATP laser beams, no "magic" — if a mechanism is unsettled, the film shows *where* the label is over time, not a made-up mechanism.
  42. ## Case study: the secretory pathway (high-school textbook)
  43. People's Education Press *Biology, Compulsory 1*, §3.2 "Synthesis and transport of secretory proteins" — a guinea-pig pancreatic acinar cell and Palade's ³H-leucine pulse-chase experiment. 87 s, 11 steps (+ a 37 s vertical showreel).
  44. | | |
  45. |---|---|
  46. | ![](examples/secretion/media/still_6.jpg) | ![](examples/secretion/media/still_13.jpg) |
  47. | A real acinus: ~9 pyramidal cells around a central lumen | Free ribosome starts the chain; signal peptide in cyan |
  48. | ![](examples/secretion/media/still_27.jpg) | ![](examples/secretion/media/still_36.jpg) |
  49. | Chain enters the RER lumen through the translocon | Vesicle on its way from the ER exit site to the cis-Golgi |
  50. | ![](examples/secretion/media/still_46.jpg) | ![](examples/secretion/media/still_64.jpg) |
  51. | Label moves cis → trans through a 6-cisterna Golgi stack | Zymogen granule heads for the apical membrane |
  52. ![](examples/secretion/media/still_80.jpg)
  53. *Replay of the pulse-chase: label appears in the RER (3 min) → Golgi (17 min) → apical vesicles & outside (117 min), textbook data.*
  54. - 🎬 Videos (720p, in repo): [lecture](examples/secretion/media/secretion_lecture_720p.mp4) · [showreel (vertical)](examples/secretion/media/secretion_showreel_720p.mp4)
  55. - 🎞 Full 1080p60 masters: see **Releases**
  56. - 🔍 Honest self-audit of organelle shapes + comparison with a viral cell video: [`examples/secretion/形态核查与对标对比.md`](examples/secretion/形态核查与对标对比.md) (Chinese)
  57. - 📝 The three review rounds that shaped it: [`examples/secretion/`](examples/secretion/) (in Chinese) — round 1 caught fabricated dashboard data and wrong organelle anatomy in the first prototype; round 2 caught label non-conservation and missing membrane dynamics; round 3 verdict: *usable for teaching with minor fixes* (both fixed before rendering).
  58. What the animation gets right (and what the reviews enforced):
  59. - the labeled protein is **conserved** — a cohort of 12 molecules, each traceable in every frame
  60. - after entering the ER, cargo is **always inside a lumen or a vesicle**
  61. - budding and fusion are **membrane events** (buds grow out of the membrane; an Ω-shaped pore opens and the vesicle membrane merges into the plasma membrane)
  62. - the ribosome stays on the **cytosolic side**; secretion is **apical only**; Golgi **in at cis, out at trans**
  63. - mitochondria have a double membrane with cristae **inside**
  64. ## How it works
  65. ```
  66. template/site2/
  67. scene-*.js procedural structures (instanced beads, seeded RNG, baked AO) + update(t, T): the process as a pure function of t
  68. story-*.js steps, camera moves, captions, legend, sources, process time windows
  69. engine.js renderer (bloom, depth of field, ACES), camera timeline, lecture overlay
  70. index.html lecture layout
  71. template/tools/
  72. record.mjs deterministic frame recorder (headless Chrome → ffmpeg), supersampling via --dpr 2 --scale
  73. sheet2.py contact sheets for review · probe.mjs / hidetest.mjs debug artifacts by ray-casting / hiding objects
  74. references/ accuracy-protocol · techniques · new-scene guide · science checklist · pitfalls · research landscape
  75. ```
  76. New topic = usually a new `story-*.js`; new organism/organelle = a new `scene-*.js` following the same interface.
  77. ## Install & run
  78. ```bash
  79. # as a Claude Code skill
  80. git clone https://github.com/moluyao/bio-viz-film ~/.claude/skills/bio-viz-film
  81. # render the example (needs Chrome + ffmpeg)
  82. cd ~/.claude/skills/bio-viz-film/template/tools && npm install
  83. cd ..
  84. node tools/record.mjs site2 out/lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080
  85. node tools/record.mjs site2 out/clean.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query layout=clean
  86. # preview live: serve template/site2 with any static server and open index.html (space = pause)
  87. ```
  88. Then just ask Claude: *"Turn textbook section X into a 3D explainer"*, *"animate viral entry for my thesis defense"*, *"make a clean 3D clip of exocytosis"*.
  89. The skill's working docs (`SKILL.md`, `references/`) are written in Chinese; Claude reads them fine in any language and will answer in yours.
  90. ## Honest limits
  91. - Procedural, **schematic** models — not molecular structures. Sizes keep only their relative order and the film says *"not to scale"*. For real PDB/cryo-EM structures use Molecular Nodes, Mol\* or ChimeraX (see `references/techniques.md`).
  92. - Reviews are done by AI sub-agents against cited sources; they catch a lot, but for publication-grade material have a domain expert sign off.
  93. - Rendering is offline (≈15–20 min for 83 s at 2× supersampled 1080p60 on a consumer GPU).
  94. ## License
  95. MIT for this skill. three.js (vendored, `template/site2/vendor`) is MIT — see `THREE_LICENSE`. Textbook wording is quoted for educational use; sources are cited on screen.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.