Agent skill

Edu Chem Reaction

by wy51ai in wy51ai/edulab

把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。

Apache-2.0Auto-check passedResearch & Science

Install Edu Chem Reaction

skills CLI
$ npx skills add wy51ai/edulab --skill edu-chem-reaction -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wy51ai/edulab edu-chem-reaction --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wy51ai/edulab.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/edu-chem-reaction .claude/skills/edu-chem-reaction && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
edu-chem-reaction
GitHub stars
1.4k
Token cost
~1.2k tokens
SKILL.md length
234 words
Files
7 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。

  • Tasks that involve Drug discovery and cheminformatics
  • SKILL.md covers 这个技能产出什么, 依赖(重要), 工作流程 and 两套引擎与自动选择, plus 2 more sections
  • Runs Python scripts from its folder; calls python3
  • Tasks that involve Math and symbolic computation

What it does

Edu Chem Reaction is an agent skill from wy51ai/edulab. 把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。 覆盖燃烧、化合/分解/置换/复分解、氧化还原(电子转移可视化)、有机机理(酯化等含催化剂·过渡态)。 统一由 sympy 精确驱动:自动配平方程、校验原子守恒与原子映射、推导键的断/成,答案与几何同源一致。 内置两套引擎并自动选择:morph(原子变形,展示原子守恒)与 mechanism(机理关键帧,展示催化/过渡态)。 混合几何:默认自建 VSEPR 分子库,环境装有 RDKit 则可用其由 SMILES 生成构象(绝不自动安装)。 其他 agent 也可调用本技能生成此类网页。形态与 edu-solid-geometry / edu-analytic-geometry 平行, 但用 Three.js + KaTeX 演示分子反应。 触发词:化学反应, 微观演示, 分子动画, 燃烧, 甲烷燃烧, 氢气燃烧, 电解水, 氧化还原…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `lib/molecules.py`, `lib/reaction_kernel.py` and `references/conventions.md`).

It sits in Research & Science, covering Drug discovery and cheminformatics, Math and symbolic computation and 3D graphics and WebGL. It works with SymPy, Three.js, RDKit and Python. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Drug discovery and cheminformatics
  • Tasks that involve Math and symbolic computation
  • Tasks that involve 3D graphics and WebGL

Example prompts

  • “/edu-chem-reaction”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6a9c876. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Edu Chem Reaction loads about 1.2k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 211 tokens; SKILL.md has 234 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~211
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from wy51ai/edulab at commit 6a9c876, republished under its Apache-2.0 licence (© wy51ai). 234 words, ~1,190 tokens.

Download SKILL.mdSave it as .claude/skills/edu-chem-reaction/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
edu-chem-reaction
description
把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。 覆盖燃烧、化合/分解/置换/复分解、氧化还原(电子转移可视化)、有机机理(酯化等含催化剂·过渡态)。 统一由 sympy 精确驱动:自动配平方程、校验原子守恒与原子映射、推导键的断/成,答案与几何同源一致。 内置两套引擎并自动选择:morph(原子变形,展示原子守恒)与 mechanism(机理关键帧,展示催化/过渡态)。 混合几何:默认自建 VSEPR 分子库,环境装有 RDKit 则可用其由 SMILES 生成构象(绝不自动安装)。 其他 agent 也可调用本技能生成此类网页。形态与 edu-solid-geometry / edu-analytic-geometry 平行, 但用 Three.js + KaTeX 演示分子反应。 触发词:化学反应, 微观演示, 分子动画, 燃烧, 甲烷燃烧, 氢气燃烧, 电解水, 氧化还原, 电子转移, 酯化反应, 反应机理, 断键成键, 原子守恒, 质量守恒, 化学方程式配平, 解这个化学反应, 随机出一个化学反应, 这张图里的化学反应; chemistry reaction, microscopic/molecular animation, combustion, electrolysis, redox electron transfer, esterification mechanism, bond breaking and forming, atom conservation, balance equation, interactive chemistry reaction page.

化学反应微观演示 → 交互网页

这个技能产出什么

一个可直接用浏览器打开的单页 HTML:一侧是反应对应的 3D 分子动画(Three.js,可旋转缩放, 拖动“反应进度”滑块逐帧看 化学键断裂/生成、原子重新组合,分步高亮 + 浮动分子标签), 另一侧是 KaTeX 反应方程 + 分步讲解 + 原子守恒计数器,并可选 能量-反应进程曲线、 火焰、催化剂质子、电子转移等叠加层。形态与 template/reaction.html 一致。

依赖(重要)

计算核心 lib/reaction_kernel.py 依赖 sympy(用于配平)。运行脚本前先确认有一个能 import sympy 的 python3:跑 python3 -c "import sympy"(本机:/opt/homebrew/bin/python3.11)。

缺库时的处理(重要):若 import 报错(sympy 或后续用到的任何库都同理),先询问用户是否安装, 同意后再装(python3 -m pip install <库名>)或换解释器;不要未经询问直接装。 RDKit 是可选项:装了则混合几何会用它由 SMILES 生成真实构象,没装就用自建 VSEPR 库—— 两种都能跑,本技能任何时候都不会自动安装 RDKit。

工作流程

第 1 步:得到 reaction spec(三入口归一)

把反应整理成结构化 spec(格式见 references/problem-schema.md):反应物/产物、原子映射或显式原子、 条件(点燃/通电/催化/可逆)、所属类别、分步讲解、语言。

  • 文字反应/方程:直接抽取反应物与产物,调 kernel 自动配平。
  • 图片:用视觉读图抽取方程,并把识别到的反应回显给用户确认(方程/条件/类别/语言)后再继续。
  • 随机出题:从注册表挑一个反应,或在库内物种间组合并用 balanced_coefficients 配平、答案规整再用。

输出语言跟随提示词语言:英文提示 → 英文网页,中文 → 中文。spec 里记下 meta.language。

第 2 步:用 kernel 精确计算(不要心算)

按 references/conventions.md 的建模约定,调用 lib/reaction_kernel.py:

  • balanced_coefficients(...) 用 sympy 零空间自动配平(方程系数有保证);
  • assemble_data(spec) 展开分子实例、校验原子守恒与原子映射双射、推导键的断/成(差集)、 算出每个原子在反应物态/产物态的世界坐标,产出注入模板的 data。

可先命令行自检:

bash
python3 lib/reaction_kernel.py     # 配平 + 守恒 + 键差 自检
python3 lib/molecules.py           # 分子库自检
第 3 步:写 build_* 拼 spec 并注入模板

📍 输出位置(重要):成品 HTML 一律写到用户当前工作目录(Path.cwd()),除非用户显式指定路径。 绝不要写进技能自身目录(skills/edu-chem-reaction/output/ 等)——那是技能内部的开发样例目录。

照着 scripts/generate.py 里的 build_* 改即可,再 render_html(K.assemble_data(spec), out):

python
from pathlib import Path
out = Path.cwd() / "reaction-<反应简述>.html"   # 落在用户当前目录
render_html(K.assemble_data(spec), out)

范例(直接照抄改):

  • build_combustion_ch4(甲烷燃烧·morph·火焰·能量)——高层 species + atom_map 的范本;
  • build_redox_na_cl2(钠+氯气·氧化还原·电子转移)——叠加 electrons;
  • build_esterification(酯化·mechanism·催化剂·过渡态)——低层 atoms + fragments + 关键帧 的范本。

generate.py 可直接出已注册反应;不传路径默认写到 cwd:

bash
python3 <技能目录>/scripts/generate.py combustion_ch4 ./reaction.html
python3 <技能目录>/scripts/generate.py list
第 4 步:自检(对应正确性方案)
  • sympy 配平系数 == 方程展示系数 == 各分子实例个数(assemble_data 内已断言)。
  • 原子映射是反应物↔产物原子的双射、元素一致;键端点都存在(kernel 已校验)。
  • 原子守恒计数器在反应前后不变(催化剂不计入)。
  • 起本地静态服务(服务输出文件所在目录)用预览检查:无控制台报错、KaTeX 方程渲染正常、 拖滑块时断键/成键高亮与分步讲解一致。

⚠️ 必须关闭你开过的端口/服务:预览检查一结束就立即停掉本地服务,绝不留下占用端口的进程。 用 preview 工具开的:检查完马上 preview_stop。交付前确认端口已释放,再告诉用户结果。

第 5 步:交付

成品写在用户当前工作目录(cwd),命名形如 reaction-<反应简述>.html,把路径告诉用户,可直接浏览器打开。 交付前确认:(1) 成品在 cwd、不在技能目录;(2) 没有遗留任何由本次预览开启的本地服务/端口。

两套引擎与自动选择

模板内置一套统一渲染器、两种逐帧定位(共用键差绘制/标签/叠加层/UI):

  • morph(原子变形):原子各自从反应物态插值到产物态,天然展示原子守恒/重组,适配任意反应。
  • mechanism(机理关键帧):原子归属刚体片段(fragment),按 K0/K1/K2 关键帧整体位移, 基团不变形,适配催化剂/过渡态/离去基团类有机机理。

assemble_data 据 meta.engine(auto/morph/mechanism)选择:auto 时,类别为 organic 或带 fragments 走 mechanism,否则走 morph。叠加层均为数据开关(见 schema): flame(燃烧/强放热)、catalyst(催化剂质子+开关)、transitionGlow(过渡态能量光)、 electrons(氧化还原电子转移)、energy(能量-反应进程曲线)、原子守恒计数器(默认开)。

配色:整体为亮色(教科书球棍图风:原子带深色描边 + 柔和投影 + 白底面板),各反应用 meta.accent 区分强调色(燃烧 amber、酯化 indigo、钠氯 violet…)。

扩展

  • 加反应:在 generate.py 加一个 build_*(高层 species+atom_map,或低层 atoms+fragments), 注册进 REGISTRY。
  • 加分子/离子:在 lib/molecules.py 的 _LIBRARY_BUILDERS 加一项(VSEPR 几何 + 显示元数据 + 内部键)。
  • 加叠加层:在 template/reaction.html 增一个由 data 字段驱动的可选模块。

目录

  • template/reaction.html — 数据驱动模板(统一渲染器 + 双引擎 + 数据岛 __REACTION_DATA__)
  • lib/molecules.py — VSEPR 理想分子几何库(含元素表/配色/半径)
  • lib/reaction_kernel.py — sympy 配平 + 守恒/映射校验 + 键差 + 场景装配 + 可选 RDKit 探测
  • scripts/generate.py — 注入模板 + 范例 build_*(含 REGISTRY 与 CLI)
  • references/problem-schema.md — reaction spec 与 data 的数据格式
  • references/conventions.md — 建模约定、引擎选择、叠加层、配平与自检

© wy51ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in skills/edu-chem-reaction of wy51ai/edulab.

  • SKILL.md
  • lib/molecules.py
  • lib/reaction_kernel.py
  • references/conventions.md
  • references/problem-schema.md
  • scripts/generate.py
  • template/reaction.html

Open the folder on GitHubat commit 6a9c876

Compare with similar skills

Edu Chem Reaction next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Edu Chem Reaction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Edu Chem Reaction this skillwy51ai/edulab1.4k—~1.2kAutomated safety check: PassApache-2.0
Molecular Visualization 3dmoljaechang-hits/SciAgent-Skills374—~3.2kAutomated safety check: PassBSD-3-Clause
SympyzLanqing/codex-claude-academic-skills4.7k15 repos~3.4kAutomated safety check: PassMIT
DiffDock Molecular DockingK-Dense-AI/scientific-agent-skills48k1 repos~3kAutomated safety check: NotesMIT
Rowanlamm-mit/scienceclaw2464 repos~3.1kAutomated safety check: WarnProprietary
Coot Rdkitpemsley/coot168—~981Automated safety check: PassGPL-3.0

Similar skills

  • Molecular Visualization 3dmol

    jaechang-hits/SciAgent-Skills

    3Dmol.js WebGL molecular visualization emitted as self-contained HTML.

    374 GitHub stars~3.2k tokensUpdated 12 days ago
    Data & AnalyticsAuto-check passed
  • Sympy

    zLanqing/codex-claude-academic-skills

    A skill your agent uses when working with symbolic mathematics in Python.

    4.7k GitHub starsUsed in 15 repos~3.4k tokens
    Research & ScienceAuto-check passed
  • DiffDock Molecular Docking

    K-Dense-AI/scientific-agent-skills

    Predicts how small molecules bind to a protein with DiffDock, covering batch docking, pose ranking by confidence and checks on the results; not for binding affinity.

    48k GitHub starsUsed in 1 repo~3k tokens
    Research & ScienceAuto-check: notes
  • Rowan

    lamm-mit/scienceclaw

    Cloud-based quantum chemistry platform with Python API. An agent skill from lamm-mit/scienceclaw.

    246 GitHub starsUsed in 4 repos~3.1k tokens
    Research & ScienceAuto-check: warnings
  • Coot Rdkit

    pemsley/coot

    RDKit molecular manipulation and visualization within Coot's Python environment.

    168 GitHub stars~981 tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • RDKit Cheminformatics

    davila7/claude-code-templates

    Guides molecular work with RDKit in Python: reading SMILES and SDF, sanitization, descriptors, fingerprints, substructure and similarity search, reactions and coordinates.

    33k GitHub starsUsed in 14 repos~5k tokens
    Research & ScienceAuto-check passed

More from wy51ai/edulab

  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check: notes
  • 把一道解析几何题解成一个自包含的交互教学网页:左栏题面 + 动态控制台(一个 可变参数滑块驱动实时重算的几何量 + 理论范围/定值指示),中栏 KaTeX 分步解析,右栏 2D Canvas 动态几何画板(椭圆/双曲线/抛物线/圆 + 动直线/动点 + 向量 + 标注 + 画笔涂鸦)。

    1.4k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: notes
  • Edu Solid Geometry

    wy51ai/edulab

    把一道立体几何题解成一个自包含的交互教学网页:左侧 MathJax 分步解析, 右侧 Three.js 可交互 3D 模型(分步高亮 + 镜头切换)。支持三种入口——给定文字题目、 随机出题、上传题目图片识别后解题。覆盖正方体/长方体、棱锥/棱柱、圆柱/圆锥上的线面角、 二面角、异面直线夹角、点到平面距离、体积等题型,统一用"建系+向量法",并由 sympy 精确 计算驱动(答案、3D…

    1.4k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Edu Physics Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a physics problem (物理题: mechanics/力学 受力分析 牛顿定律 斜面 传送带 板块 平抛 圆周 能量 动量, optics/光学 折射…

    1.4k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes

Questions about Edu Chem Reaction

What does Edu Chem Reaction do?

把一个化学反应做成自包含的微观 3D 交互演示网页:左/上为 Three.js 可交互分子动画 (拖滑块看断键·成键·原子重组,分步高亮),右为 KaTeX 反应方程 + 分步讲解 + 原子守恒计数 + 可选能量-反应进程曲线。支持三入口——给定文字反应/方程、随机出题、上传图片识别后演示。. Edu Chem Reaction is an agent skill from wy51ai/edulab.

When should I use Edu Chem Reaction?

Edu Chem Reaction fits situations like: tasks that involve Drug discovery and cheminformatics; tasks that involve Math and symbolic computation; tasks that involve 3D graphics and WebGL.

How do I install Edu Chem Reaction in Claude Code?

Run `npx skills add wy51ai/edulab --skill edu-chem-reaction -a claude-code`. Or copy the skill folder (skills/edu-chem-reaction in wy51ai/edulab) into .claude/skills/edu-chem-reaction in your project. Claude Code loads it when a task matches its description.

How do I install Edu Chem Reaction in Codex?

Run `npx skills add wy51ai/edulab --skill edu-chem-reaction -a codex`. Or copy the skill folder (skills/edu-chem-reaction in wy51ai/edulab) into .agents/skills/edu-chem-reaction in your project. Codex loads it when a task matches its description.

Can I use Edu Chem Reaction in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wy51ai/edulab --skill edu-chem-reaction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/edu-chem-reaction, .gemini/skills/edu-chem-reaction, .github/skills/edu-chem-reaction and .opencode/skills/edu-chem-reaction in your project.

What does Edu Chem Reaction need to run?

Going by SKILL.md and its folder, Edu Chem Reaction needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Edu Chem Reaction access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Edu Chem Reaction safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Edu Chem Reaction use?

Edu Chem Reaction is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Edu Chem Reaction use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Edu Chem Reaction?

Skills that share tags, products or a category with Edu Chem Reaction: Molecular Visualization 3dmol (jaechang-hits/SciAgent-Skills, 374 stars), Sympy (zLanqing/codex-claude-academic-skills, 4.7k stars), DiffDock Molecular Docking (K-Dense-AI/scientific-agent-skills, 48k stars) and Rowan (lamm-mit/scienceclaw, 246 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Edu Chem Reaction?

wy51ai (a GitHub user) maintains it in wy51ai/edulab, which has 1,406 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

Source: wy51ai/edulab on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.