edu-math-tutorial
agentscope-ai/QwenPaw · Agent Skill
Generates step-by-step math tutorial videos, breaking down problems into stages and providing narration scripts and visual guidance.
Jump to install ↓Overview
| Publisher | |
|---|---|
| Repository | agentscope-ai/QwenPaw ↗ |
| Skill folder | edu-math-tutorial |
| Stars | 35,046 |
| Bundled files | 1 |
| License | Apache-2.0 |
| Last updated | August 10, 2026 |
| Links | Skill source ↗ · Repository ↗ |
Mozgi check
What we found in the skill files. Details come with a subscription.
Installation
A skill is a folder with a SKILL.md file. Pick your agent and run the commands in a terminal (macOS, Linux or Git Bash on Windows) from your project root.
Copy the prompt into Claude, Codex or another assistant: it will review the skill and install it for you.
Install the “edu-math-tutorial” skill from mozgi.io (https://mozgi.io/skills/edu-math-tutorial/) for me. 1. Download the archive: https://mozgi.io/skills/edu-math-tutorial/download If it fails, take the skill folder from the source: https://github.com/agentscope-ai/QwenPaw/tree/main/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial 2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me. 3. Put the “edu-math-tutorial” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.). 4. Make sure <skills folder>/edu-math-tutorial/SKILL.md exists. 5. Briefly tell me what this skill does and offer to try it on my task. If you cannot do a step yourself, tell me what to click or type.
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .claude/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .claude/skills/edu-math-tutorial
Restart Claude Code — the skill appears in the list; call it manually with /edu-math-tutorial. For all projects use ~/.claude/skills.
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .agents/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .agents/skills/edu-math-tutorial
Codex looks for skills in .agents/skills from the current folder up to the repo root; call one with /skills or $edu-math-tutorial. For all projects use ~/.agents/skills.
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .cursor/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .cursor/skills/edu-math-tutorial
Cursor picks the skill up on start; call it with “/” in Agent chat. Cursor also reads .claude/skills and .agents/skills. For all projects use ~/.cursor/skills.
git clone --depth 1 --branch main https://github.com/agentscope-ai/QwenPaw.git /tmp/QwenPaw mkdir -p .gemini/skills cp -r /tmp/QwenPaw/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .gemini/skills/edu-math-tutorial
Gemini CLI offers to activate the skill when a task matches — you approve it. For all projects use ~/.gemini/skills.
Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.
SKILL.md contents
Original author text · read-only数学讲解视频 · 领域知识
本 skill 指导如何把一道数学题组织成高质量的分步讲解视频。它不提供渲染脚本:
每个讲解场景是主时间轴上的一个 creation.type=motion_clip Element,旁白是
creation.type=audio Element,成片由 Creator 的确定性渲染管线合成。
1. 题目拆解方法
先完成解题分析,再规划视频。按顺序产出三层事实(写进委派任务书,不需要落盘):
1. 题面:完整题目文本,全部数学表达式用 LaTeX 表示;有图形时先文字化描述。
2. 解法链:选择最常规、面向学生的解法,把过程拆成 2–5 个原子步骤,每步
只做一件事。一元一次方程的标准链是:移项 → 合并同类项 → 系数化为 1;
几何题的标准链是:读图标注 → 引用定理 → 代入求解。
3. 易错点:每步至多标注一个学生最易犯的错误(如"移项要变号"),在旁白
与画面中同步提醒。
2. 视频结构与讲解节奏
固定五段式结构,每段一个场景(motion_clip Element):
| 段落 | 内容 | 时长基准 |
|------|------|---------|
| 开场 | 完整题面 + 一句目标("我们的目标是求出 x") | 6–10s |
| 步骤 N | 每个原子步骤一段:上一步结果 → 本步操作标注 → 本步结果 | 各 8–14s |
| 收尾 | 最终答案 + 一句验算或总结 | 5–8s |
节奏规则:
- 旁白按语速约 4.5 字/秒估算时长;场景时长 = 对应旁白时长 + 1–2s 静读缓冲。
- 每段旁白 1–3 句,单句不超过 25 字;步骤段先说操作依据,再报结果。
- 相邻场景之间内容必须有承接:下一场景开头展示上一场景的结论("上一步"栏)。
3. 旁白文案规范
- 全程中文口语,数学式读法固定:
5x-7=13读作"5x 减 7 等于 13";分数读作
"5 分之 20";除法读作"20 除以 5"。不读 LaTeX 符号本身。
- 操作句式:"把常数项负 7 移到等号右边,移项要变号,所以右边变成 13 加 7。"
- 每句都要能独立成字幕:不用"然后呢"“接下来我们再"之类的口头填充词。
- 旁白文本写入对应 audio Element 的
creation.script,后续可改词重合成。 - 旁白逐句同步上字幕:每一句旁白对应一张字幕卡(见第 5 节),字幕文本必须与该句旁白逐字一致。
4. 版式与画面风格(motion_clip 的 prompt 要点)
每个场景的 creation.prompt 用自然语言写清画面意图,包含以下要素,实际动效
文档由 design_motion_overlays 生成(不要手写 creation.motion):
- 主题:默认"Aurora Scholar"——浅色淡紫/靛蓝渐变背景、柔和光斑;同一
视频内所有场景共用一个主题。
- 教学面板:白色实心不透明圆角卡片承载公式与步骤(禁止半透明磨砂),
卡片带分层柔和阴影;步骤编号用紫色圆形徽标。
- 公式排版:数学表达式按 KaTeX 风格排版(衬线斜体变量、正体数字与
运算符),题面/结果公式为视觉主体、居中放大;操作说明用小号胶囊标签放在
两个公式之间(如"将 -7 移到右边,变号为 +7")。
- 步骤卡布局:"上一步"公式在上(浅灰底栏),操作标签居中,"得到"结果
在下(浅绿底栏高亮)。
- 画面文字全中文:步骤徽标、操作标签、栏目标题("上一步""得到"等)一律
用中文,禁止出现英文标注;每段卡片内容必须与本段旁白所讲的步骤严格一致
(写 prompt 时把本段旁白原文附在后面作为对齐锚)。
- 字幕:由独立的字幕 Overlay Element 承担(见第 5 节),不要画进
motion_clip 文档里;教学面板预留底部约 15% 高度的留白,确保字幕不与
面板重叠。
- 动效:入场用轻柔上浮淡入,公式变化处做逐项高亮;不使用炫技转场。
5. 落地为 Creator 原生结构(执行流程)
1. 按第 1–2 节完成拆解与分段规划,估算每段旁白文本与时长。
2. 委派 ai_editing_director 到 timeline:<timelineId>,任务书写明:
- 按分段各创建一个
creation.type=motion_clip的主轨 Element(span 按
第 2 节时长基准顺序接排,creation.prompt 按第 4 节要点写足画面内容,
包含该段的具体公式 LaTeX、中文操作标注文字与本段旁白原文);
- 为每段创建
creation.type=audio的旁白 Element(creation.script用
第 3 节规范的文案,span 与对应场景对齐);
- 为每一句旁白创建一个
creation.type=overlay的字幕 Element:text
填该句旁白原文(逐字一致,不改写不省略),span 按该句在本段内的
时间位置排布(按字数占比分配本段时长),location 用底部居中胶囊
默认值 x=0.50, y=0.88, width=0.80, height=0.14;字幕不可省略,
每句旁白都必须有对应字幕覆盖其时段;
- 写入后调用
design_motion_overlays生成各 motion_clip 的动效文档
与字幕卡样式,必须同时传 captionStyle="uniform" 和
sceneStyle="edu_steps":解说字幕全片用同一固定模板,只换文字;
教学场景用确定性推导卡模板(步骤徽章/上一步/推导行/结果高亮固定
骨架,底部自带字幕留白),模型只填内容文案且强制中文,全片版式
绝对一致。为此每个 motion_clip 的 prompt 只需写清本段要讲的内容
(步骤名、上一步公式、本步推导、结果),不需要描述视觉风格。
3. 成片合成走 Creator 确定性渲染(用户在 UI 上或由既有 compose 流程触发),
不在任何沙箱内渲染视频。
4. 自查:逐场景核对公式推导正确、画面标注全中文且与本段旁白一致、每句旁白
都有字幕且不与面板重叠、字幕样式全篇一致、场景时长覆盖对应旁白。
Frequently asked questions
What does the edu-math-tutorial skill do?
Generates step-by-step math tutorial videos, breaking down problems into stages and providing narration scripts and visual guidance.
How do I install edu-math-tutorial?
Open the “Installation” block on this page and pick your agent — Claude Code, Codex, Cursor or Gemini CLI — for ready-made commands that copy the skill folder to the right place. Or copy the prompt from the “Via assistant” tab and let the assistant review and install the skill.
Which AI models work with edu-math-tutorial?
Skills are plain Markdown instructions (the Agent Skills format), so edu-math-tutorial works with any agent that reads SKILL.md: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and more. The model loads the instructions only when a task matches the skill's description.
Is edu-math-tutorial free?
The skill is published openly by agentscope-ai under the Apache-2.0 license. The skill itself costs nothing — you only pay your AI provider for the tokens you use.
Is it safe to install skills?
A skill is a set of instructions your agent will follow, so read SKILL.md and its companion files before installing. Scripts in the skill folder only run if your agent runs them — keep an eye on what it does and do not grant unnecessary permissions.
How is a skill different from an MCP server or a plugin?
An MCP server or plugin gives the model new tools — code that runs and returns a result. A skill gives it knowledge and process: how to approach a task, which steps to follow and what good output looks like. It needs no server or API key.