Another open-source math skill — convert math problems into .ggb files. If the problem is a geometry image, the model needs vision capabilities (Opus or GPT). If the geometry has movable points, it generates an interactive .ggb file where you can freely drag points to see how the figure changes. This helps teachers digitize textbook problems and helps students understand the problems.

A middle school teacher from Liaoning saw the math visualization skill on my WeChat Official Account and reached out. He had been struggling for a long time with Gemini and only managed to produce a mediocre HTML file; he asked if I could make it work. I tried both Claude and Codex and it worked. He actually had Codex too, but gave up after failing. There’s still a long way to go in teaching people how to use AI.

Image 1 is the original problem; the video shows the effect of the generated interactive .ggb file.

Github: https://github.com/GordenSun/Math2GGB…

GordenSun/Math2GGB

Source: https://github.com/GordenSun/Math2GGB

Math2GGB

A Cursor Agent Skill that turns a math problem (especially geometry) into GeoGebra .ggb files. For each figure it produces three files built from the SAME dependency-constrained construction:

• a 静态复刻图 (static faithful) — the printed figure reproduced exactly (only its points, segments, and angle marks, no more no less);
• a 干净可交互图 (clean interactive) — the same print-identical look with no text/aids/visible helper circles, but fully draggable with every condition preserved;
• a 动态理解图 (dynamic teaching) — the same base plus auxiliary lines, annotations, and live angle/length readouts on a 显示辅助 toggle — unchecking it returns to the exact original.

All three encode the problem’s conditions as real constraints (concyclic, intersection, reflection, midpoint, spiral similarity, locus…), so dragging a driver point keeps every condition satisfied. Precise reproduction is enforced by measuring the original image (never eyeballing) and by adding temporary measurement objects to verify coordinates/lengths/angles, which are deleted before export so the final file matches the original exactly.

It works by driving the real GeoGebra engine in a browser (GeoGebra’s own JS API) and exporting with getBase64(), so the produced files always open in GeoGebra — no fragile hand-written XML.

Install

Copy this folder into your Cursor skills directory:

# Personal (all projects):
cp -R Math2GGB ~/.cursor/skills/math2ggb
# or Project (this repo only):
cp -R Math2GGB /.cursor/skills/math2ggb

Then just ask the agent, e.g. “把这道几何题做成 GeoGebra 文件” / “make an interactive GeoGebra of this problem”.

Layout

Math2GGB/
├── SKILL.md              # main orchestration (stages A–E)
├── references/
│   ├── geogebra-recipes.md   # commands, JS API, image-measuring, condition→constraint table, gotchas
│   └── example-hidden-circle.md  # verified example (静态复刻图 + 干净可交互图 + 动态理解图)
├── scripts/
│   └── ggb_server.py         # serves generator + receives exported .ggb
└── templates/
    └── generator.html        # loads the real GeoGebra engine (AG layout)

Requirements

• A browser tool (navigate, evaluate JS, screenshot).
• Internet (the generator page loads GeoGebra from geogebra.org’s CDN).
• python3.

Opening the output on macOS

The App Store GeoGebra Classic 6 is sandboxed: double-clicking a .ggb (or passing it on the command line) shows a blank window. Open via ☰ menu → Open → From this device → pick the file, or drag the file onto the GeoGebra window. The web app (geogebra.org/classic) opens files normally.

Gorden Sun (@Gorden_Sun): 再开源一个技能:一键生成可视化数学讲解视频

提示词: 安装这个Skill:https://t.co/otI2ZDfdlf 然后使用这个Skill给小学生讲解:给小学生讲解□+28=□x5

下方2个视频是我生成的效果。