Agent skill

Edu Solid Geometry

by wy51ai in wy51ai/edulab

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

Apache-2.0Auto-check passedResearch & Science

Install Edu Solid Geometry

skills CLI
$ npx skills add wy51ai/edulab --skill edu-solid-geometry -a claude-code

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

GitHub CLI
$ gh skill install wy51ai/edulab edu-solid-geometry --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-solid-geometry .claude/skills/edu-solid-geometry && 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-solid-geometry
GitHub stars
1.4k
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
246 words
Files
7 (incl. scripts, references)
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Tasks that involve Math and symbolic computation
  • SKILL.md covers 这个技能产出什么, 依赖(重要), 工作流程 and 扩展, plus 1 more section
  • Runs Python scripts from its folder; calls python3
  • Tasks that involve 3D graphics and WebGL

What it does

Edu Solid Geometry is an agent skill from wy51ai/edulab. 把一道立体几何题解成一个自包含的交互教学网页:左侧 MathJax 分步解析, 右侧 Three.js 可交互 3D 模型(分步高亮 + 镜头切换)。支持三种入口——给定文字题目、 随机出题、上传题目图片识别后解题。覆盖正方体/长方体、棱锥/棱柱、圆柱/圆锥上的线面角、 二面角、异面直线夹角、点到平面距离、体积等题型,统一用"建系+向量法",并由 sympy 精确 计算驱动(答案、3D 坐标、步骤数值同源一致)。其他 agent 也可调用本技能生成此类网页。 触发词:立体几何, 线面角, 二面角, 异面直线, 点到平面距离, 正四棱锥, 正方体求角, 解这道几何题, 随机出一道立体几何题, 这张图里的立体几何题; solid geometry, line-plane angle, dihedral angle, angle between skew lines, distance to plane, interactive geometry solution page.

Its SKILL.md is about 1.1k 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/bodies.py`, `lib/geometry_kernel.py` and `references/conventions.md`).

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

When your agent uses it

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

Example prompts

  • “建系+向量法”
  • “/edu-solid-geometry”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 8f510e3. 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 Solid Geometry loads about 1.1k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 246 words of instructions outside code blocks.

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

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 8f510e3, republished under its Apache-2.0 licence (© wy51ai). 246 words, ~1,058 tokens.

Download SKILL.mdSave it as .claude/skills/edu-solid-geometry/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
edu-solid-geometry
description
把一道立体几何题解成一个自包含的交互教学网页:左侧 MathJax 分步解析, 右侧 Three.js 可交互 3D 模型(分步高亮 + 镜头切换)。支持三种入口——给定文字题目、 随机出题、上传题目图片识别后解题。覆盖正方体/长方体、棱锥/棱柱、圆柱/圆锥上的线面角、 二面角、异面直线夹角、点到平面距离、体积等题型,统一用"建系+向量法",并由 sympy 精确 计算驱动(答案、3D 坐标、步骤数值同源一致)。其他 agent 也可调用本技能生成此类网页。 触发词:立体几何, 线面角, 二面角, 异面直线, 点到平面距离, 正四棱锥, 正方体求角, 解这道几何题, 随机出一道立体几何题, 这张图里的立体几何题; solid geometry, line-plane angle, dihedral angle, angle between skew lines, distance to plane, interactive geometry solution page.

立体几何解题 → 交互网页

这个技能产出什么

一个可直接用浏览器打开的单页 HTML:左侧题面/答案/分步解析(公式用 MathJax), 右侧是题目对应的 3D 模型(Three.js,可旋转缩放,分步高亮关键元素并切换镜头)。 形态与 template/lesson.html 一致。

依赖(重要)

计算核心 lib/geometry_kernel.py 依赖 sympy。运行脚本前先确认有一个能 import sympy 的 python3:跑 python3 -c "import sympy"。

缺库时的处理(重要):若 import 报错(sympy 或后续用到的任何库都同理),先询问用户是否安装, 得到同意后再帮忙安装(python3 -m pip install <库名>),或换一个已装该库的解释器;不要未经询问直接装。 下文命令里的 python3 均指这个能跑通依赖的解释器。

工作流程

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

把题目整理成结构化 spec(格式见 references/problem-schema.md):几何体类型与尺寸、 已知构造点/条件、所求类型与对象、语言。

  • 文字题目:直接抽取。
  • 图片:用视觉读图抽取,并把识别到的题目回显给用户确认(题面/几何体/尺寸/所求/语言)后再继续。
  • 随机出题:选定几何体与题型,用 kernel 随机参数求解,答案不规整就重抽。

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

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

按 references/conventions.md 的建系约定与解法配方,调用 lib/geometry_kernel.py: 得到精确坐标、关键向量、法向量、最终答案,以及各步骤要展示的中间量(均为 LaTeX 字符串)。 顶点的 three.js 坐标用 kernel.to_three(points, scale) 得到。

可先在命令行跑 kernel 验证答案,例如:

bash
python3 lib/geometry_kernel.py    # 内置样例自检
第 3 步:组装 lesson data 并注入模板

📍 输出位置(重要):成品 HTML 一律写到用户当前工作目录(Path.cwd()),除非用户显式指定路径。 绝不要写进技能自身目录(skills/edu-solid-geometry/output/ 等)——那是技能内部的开发样例目录。 临时构建脚本也放到 cwd 或临时目录(如 /tmp),用完可删。

写一个临时构建脚本,导入 kernel、bodies、generate,拼出 lesson / steps / model 数据 (schema 见 references/problem-schema.md),再调用 generate.render_html(data, out) 注入模板产出 HTML。 out 用 cwd 下的绝对路径:

python
from pathlib import Path
out = Path.cwd() / "solution-<题目简述>.html"   # 落在用户当前目录,而非技能目录
generate.render_html(data, out)
  • steps[*].content 里的所有数值直接引用 kernel 的计算结果,模型只负责组织讲解文字(按目标语言书写)。
  • model.points 用 kernel.to_three(...) 的结果;model.spheres/edges 用 lib/bodies.py 的拓扑 (quad_pyramid / tri_pyramid / cuboid / cube / prism),罕见几何体可手写 edges。
  • 每步配 highlight(该步可见元素的绝对集合)与 cameraPos。
  • 题面给出线段长度时:为对应棱加 measure 元素(label 用 LaTeX,如 2\sqrt{2}), 并把它放进"建系/列已知条件"那步的 highlight,在 3D 图中点处标出长度(见 problem-schema)。
  • 英文输出时填 lesson.ui 英文文案并设 lesson.language="en"。

可直接参考的范例:scripts/generate.py 里的 build_data()(正四棱锥·线面角)、 build_cube_data()(正方体·线面角)、build_box_volume_data()(长方体·体积)都是完整范本,照着改即可。

generate.py 可直接出已注册的题;不传路径时默认写到当前工作目录(cwd),也可显式给 cwd 下的文件名 (用技能目录里的 scripts/generate.py,输出落在 cwd):

bash
python3 <技能目录>/scripts/generate.py cube ./cube.html
python3 <技能目录>/scripts/generate.py box  ./box.html

随机出题:generate.py random <seed> [输出.html],内部用 kernel.is_clean(...) 判答案规整、不过重抽:

bash
python3 <技能目录>/scripts/generate.py random 7 ./random.html   # 不给路径则默认 ./random.html(cwd)

扩展随机题型时沿用"随机参数 → 求解 → is_clean 不过就重抽"。

第 4 步:自检(对应正确性方案)
  • kernel 答案 == 答案卡 answerValue == 末步骤展示的最终值(generate.py 已有断言示例)。
  • 3D 顶点坐标来自 kernel.to_three(与解题同源)。
  • 起本地静态服务(服务输出文件所在目录,即 cwd)用预览检查:无控制台报错、公式渲染正常、分步高亮/镜头符合预期。 (技能仓库内开发时可用 .claude/launch.json 的 geom-preview;在别处运行就对 cwd 起一个临时静态服务。)

⚠️ 必须关闭你开过的端口/服务:预览检查一结束就立即停掉本地服务,绝不留下占用端口的进程。

  • 用 preview 工具开的:检查完马上 preview_stop(传对应 serverId)。
  • 直接起的 http.server:用完 kill 掉,或核对 lsof -nP -iTCP:<port> -sTCP:LISTEN 确认已释放。
  • 交付前确认端口已释放,再告诉用户结果。开了不关 = 未完成自检。
第 5 步:交付

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

扩展

  • 加题型:在 geometry_kernel.py 加求解函数(见 conventions 配方表),在 generate.py 加一个 build_*。
  • 加几何体:在 geometry_kernel.py 加坐标构建函数,在 bodies.py 加棱拓扑。

目录

  • template/lesson.html — 数据驱动模板(通用 3D 渲染器 + 数据岛 __LESSON_DATA__)
  • lib/geometry_kernel.py — sympy 精确计算核心
  • lib/bodies.py — 几何体棱拓扑库
  • scripts/generate.py — 注入模板 + 范例构建函数
  • references/problem-schema.md — 数据格式
  • 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-solid-geometry of wy51ai/edulab.

  • SKILL.md
  • lib/bodies.py
  • lib/geometry_kernel.py
  • references/conventions.md
  • references/problem-schema.md
  • scripts/generate.py
  • template/lesson.html

Open the folder on GitHubat commit 8f510e3

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wy51ai/edulab, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Edu Solid Geometry 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 Solid Geometry compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Edu Solid Geometry this skillwy51ai/edulab1.4k1 repos~1.1kAutomated safety check: PassApache-2.0
SympyzLanqing/codex-claude-academic-skills4.6k16 repos~3.4kAutomated safety check: PassMIT
SympyK-Dense-AI/scientific-agent-skills48k1 repos~3.3kAutomated safety check: NotesMIT
Sympy Symbolic Mathjaechang-hits/SciAgent-Skills3701 repos~3.9kAutomated safety check: PassBSD-3-Clause
Image to Three.js Modelimg2threejs/img2threejs18k1 repos~8.2kAutomated safety check: PassApache-2.0
Blender Web Export Pipelinefreshtechbro/claudedesignskills986—~4.2kAutomated safety check: PassMIT

Similar skills

  • Sympy

    zLanqing/codex-claude-academic-skills

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

    4.6k GitHub starsUsed in 16 repos~3.4k tokens
    Research & ScienceAuto-check passed
  • Sympy

    K-Dense-AI/scientific-agent-skills

    Performs exact symbolic mathematics with SymPy for algebra, calculus, equation solving, symbolic linear algebra, physics, and lambdify or LaTeX code generation.

    48k GitHub starsUsed in 1 repo~3.3k tokens
    Research & ScienceAuto-check: notes
  • Sympy Symbolic Math

    jaechang-hits/SciAgent-Skills

    Symbolic math in Python: exact algebra, calculus (derivatives, integrals, limits), equation solving, symbolic matrices, ODEs, code gen (lambdify, C/Fortran).

    370 GitHub starsUsed in 1 repo~3.9k tokens
    Research & ScienceAuto-check passed
  • Image to Three.js Model

    img2threejs/img2threejs

    Rebuilds the object in a reference image as a procedural, animation-ready Three.js model written entirely in code, using staged sculpting with quality checks.

    18k GitHub starsUsed in 1 repo~8.2k tokens
    Game DevelopmentAuto-check passed
  • Blender Web Export Pipeline

    freshtechbro/claudedesignskills

    Exports and optimizes Blender 3D models and animations for the web as glTF, covering batch Python scripting, texture baking, decimation and LOD generation for Three.js and Babylon.js.

    986 GitHub stars~4.2k tokensUpdated 10 mo ago
    Game DevelopmentAuto-check passed
  • Substance 3D Texturing

    freshtechbro/claudedesignskills

    Comprehensive skill for Adobe Substance 3D Painter texturing and material creation workflow.

    986 GitHub stars~4k tokensUpdated 10 mo ago
    Game DevelopmentAuto-check passed

More from wy51ai/edulab

  • 把一道解析几何题解成一个自包含的交互教学网页:左栏题面 + 动态控制台(一个 可变参数滑块驱动实时重算的几何量 + 理论范围/定值指示),中栏 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 9 days ago
    Auto-check: notes
  • Edu Chem Reaction

    wy51ai/edulab

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

    1.4k GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed

Questions about Edu Solid Geometry

What does Edu Solid Geometry do?

把一道立体几何题解成一个自包含的交互教学网页:左侧 MathJax 分步解析, 右侧 Three.js 可交互 3D 模型(分步高亮 + 镜头切换)。支持三种入口——给定文字题目、 随机出题、上传题目图片识别后解题。覆盖正方体/长方体、棱锥/棱柱、圆柱/圆锥上的线面角、 二面角、异面直线夹角、点到平面距离、体积等题型,统一用"建系+向量法",并由 sympy 精确 计算驱动(答案、3D…. Edu Solid Geometry is an agent skill from wy51ai/edulab.js 可交互 3D 模型(分步高亮 + 镜头切换)。支持三种入口——给定文字题目、 随机出题、上传题目图片识别后解题。覆盖正方体/长方体、棱锥/棱柱、圆柱/圆锥上的线面角、 二面角、异面直线夹角、点到平面距离、体积等题型,统一用"建系+向量法",并由 sympy 精确 计算驱动(答案、3D 坐标、步骤数值同源一致)。其他 agent 也可调用本技能生成此类网页。 触发词:立体几何, 线面角, 二面角, 异面直线, 点到平面距离, 正四棱锥, 正方体求角, 解这道几何题, 随机出一道立体几何题, 这张图里的立体几何题; solid geometry, line-plane angle, dihedral angle, angle between skew lines, distance to plane, interactive geometry solution page.

When should I use Edu Solid Geometry?

Edu Solid Geometry fits situations like: tasks that involve Math and symbolic computation; tasks that involve 3D graphics and WebGL.

How do I install Edu Solid Geometry in Claude Code?

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

How do I install Edu Solid Geometry in Codex?

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

Can I use Edu Solid Geometry 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-solid-geometry -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-solid-geometry, .gemini/skills/edu-solid-geometry, .github/skills/edu-solid-geometry and .opencode/skills/edu-solid-geometry in your project.

What does Edu Solid Geometry need to run?

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

Does Edu Solid Geometry 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 Solid Geometry 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 Solid Geometry use?

Edu Solid Geometry 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 Solid Geometry use?

About 1.1k tokens (SKILL.md is roughly 4.2k 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.3k tokens, read only when the agent opens those files.

What are the alternatives to Edu Solid Geometry?

Skills that share tags, products or a category with Edu Solid Geometry: Sympy (zLanqing/codex-claude-academic-skills, 4.6k stars), Sympy (K-Dense-AI/scientific-agent-skills, 48k stars), Sympy Symbolic Math (jaechang-hits/SciAgent-Skills, 370 stars) and Image to Three.js Model (img2threejs/img2threejs, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Edu Solid Geometry?

wy51ai (a GitHub user) maintains it in wy51ai/edulab, which has 1,360 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 28, 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.