Agent skill

Math Tutorial Video Planner

by agentscope-ai in agentscope-ai/QwenPaw

Domain guidance for turning one math problem into a step-by-step explainer video in Chinese, with scene timing, narration rules and KaTeX-style layout.

Apache-2.0Auto-check passedEducation

SKILL.md written in Chinese; this summary is our English description.

Install Math Tutorial Video Planner

skills CLI
$ npx skills add agentscope-ai/QwenPaw --skill edu-math-tutorial -a claude-code

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

GitHub CLI
$ gh skill install agentscope-ai/QwenPaw edu-math-tutorial --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/agentscope-ai/QwenPaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial .claude/skills/edu-math-tutorial && 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-math-tutorial
GitHub stars
35k
Token cost
~783 tokens
SKILL.md length
221 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
Apache-2.0

At a glance

Domain guidance for turning one math problem into a step-by-step explainer video in Chinese, with scene timing, narration rules and KaTeX-style layout.

  • Works in 5 steps: 题目拆解方法 → 视频结构与讲解节奏 → 旁白文案规范 → …
  • Making a worked-solution video for a math problem
  • SKILL.md covers 1. 题目拆解方法, 2. 视频结构与讲解节奏, 3. 旁白文案规范 and 4. 版式与画面风格(motion_clip 的…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill supplies know-how rather than render scripts. It tells the agent to break a problem into three layers: the full problem text with formulas in LaTeX, a solution chain of two to five atomic steps, and at most one common student mistake per step to flag in narration and on screen. Standard chains are included, for example moving terms, combining like terms and dividing by the coefficient for a linear equation.

Videos follow a fixed five-part structure of an opening, step scenes and a closing, with scene length set by the narration at about 4.5 characters per second plus a short reading buffer, and each narration line holds one to three short sentences. Visual guidance covers the Aurora Scholar theme, opaque white cards, step badges, centered formulas and Chinese-only on-screen text, while subtitles are separate overlay elements. In Creator each scene is a motion_clip element and the narration an audio element, delegated to an editing director and rendered by a deterministic pipeline.

When your agent uses it

  • Making a worked-solution video for a math problem
  • Planning narration and scene timing for a Chinese math tutorial
  • Laying out equation steps with highlighted results

Example prompts

  • “Explain how to solve 5x minus 7 equals 13 as a step-by-step video.”
  • “Make a tutorial video for this triangle problem: read the diagram, cite the theorem, then solve.”

Requirements

  • QwenPaw Creator with its motion_clip and audio elements

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 题目拆解方法
  2. 视频结构与讲解节奏
  3. 旁白文案规范
  4. 版式与画面风格(motion_clip 的 prompt 要点)
  5. 落地为 Creator 原生结构(执行流程)

What it can do on your machine

Read from SKILL.md and the folder at commit 80e412d. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Math Tutorial Video Planner loads about 783 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 221 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~783

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from agentscope-ai/QwenPaw at commit 80e412d, republished under its Apache-2.0 licence (© agentscope-ai). 221 words, ~783 tokens.

Download SKILL.mdSave it as .claude/skills/edu-math-tutorial/SKILL.md (or your agent's skills folder).
name
edu-math-tutorial
description
数学题分步讲解视频的领域知识。适用场景:(1) 用户给出一道数学题并要求做讲解/ 解题视频;(2) 用户说"讲解这道题"、"生成解题视频"、"make a math tutorial"; (3) 需要中文数学教学视频,涉及方程、公式或几何图形。本 skill 只提供领域 知识(题目拆解、讲解节奏、旁白文案规范、版式与 KaTeX 排版风格);画面、 配音与成片一律用 Creator 原生 Element 与工具从源头构建。

数学讲解视频 · 领域知识

本 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. 自查:逐场景核对公式推导正确、画面标注全中文且与本段旁白一致、每句旁白 都有字幕且不与面板重叠、字幕样式全篇一致、场景时长覆盖对应旁白。

© agentscope-ai, 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

Just SKILL.md in plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial of agentscope-ai/QwenPaw.

Open the folder on GitHubat commit 80e412d

Compare with similar skills

Math Tutorial Video Planner 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.

Math Tutorial Video Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Math Tutorial Video Planner this skillagentscope-ai/QwenPaw35k—~783Automated safety check: PassApache-2.0
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch65k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
AI Engineering Course Guiderohitg00/ai-engineering-from-scratch65k—~1.7kAutomated safety check: PassMIT
Claude Academy Guideanthropics/skills180k3 repos~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    65k GitHub stars~1.6k tokensUpdated today
    EducationAuto-check passed
  • Hung-Yi Lee Teaching Style

    voidful/hung-yi-lee-skill

    Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.

    1.3k GitHub stars~13k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • AI Engineering Course Guide

    rohitg00/ai-engineering-from-scratch

    Routes a topic, question or bug to the exact lessons in the AI Engineering from Scratch curriculum and suggests the next command to run.

    65k GitHub stars~1.7k tokensUpdated today
    EducationAuto-check passed
  • Claude Academy Guide

    anthropics/skills

    Official

    Adds a matching Claude Academy course, tutorial or use case to the end of an answer about learning to use Claude, but only when the match is strong.

    180k GitHub starsUsed in 3 repos~1.9k tokens
    EducationAuto-check passed
  • Turns a concept or lesson material into a Feynman-style classroom where learners explain first, find their smallest gap, rebuild the idea and apply it somewhere new.

    40k GitHub stars~955 tokensUpdated today
    EducationAuto-check passed

More from agentscope-ai/QwenPaw

All 20 skills in this repo
  • Terraform and OpenTofu Guide

    agentscope-ai/QwenPaw

    Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.

    35k GitHub starsUsed in 6 repos~4.2k tokens
    Auto-check passed
  • Make Skill

    agentscope-ai/QwenPaw

    Turns reusable decisions, templates or workflows from the current conversation into a new workspace skill through plan, approval, draft, validation and publication.

    35k GitHub stars~2.4k tokensUpdated 7 days ago
    Auto-check passed
  • QwenPaw Make Skill

    agentscope-ai/QwenPaw

    Creates a focused workspace skill from the current conversation in QwenPaw, moving through a planning, approval, drafting, validation and publishing script pipeline.

    35k GitHub stars~1.2k tokensUpdated 7 days ago
    Auto-check passed
  • QwenPaw Scheduled Tasks

    agentscope-ai/QwenPaw

    Creates and manages scheduled or recurring jobs with the qwenpaw cron commands, always tied to an explicit agent ID and a confirmed target channel.

    35k GitHub stars~2.3k tokensUpdated 7 days ago
    Auto-check passed
  • DOCX Creation and Editing

    agentscope-ai/QwenPaw

    Creates, reads and edits Word .docx files, including tracked changes and comments, using docx-js for new files and XML editing for existing ones.

    35k GitHub stars~3.3k tokensUpdated 7 days ago
    Auto-check passed
  • Mailbox Operations Hub

    agentscope-ai/QwenPaw

    Connects, registers, and operates a personal mailbox, reading, searching, sending, and organizing, through a managed mail server for nine domains.

    35k GitHub stars~2.6k tokensUpdated 7 days ago
    Auto-check passed

Works with

Questions about Math Tutorial Video Planner

What does Math Tutorial Video Planner do?

Domain guidance for turning one math problem into a step-by-step explainer video in Chinese, with scene timing, narration rules and KaTeX-style layout. This skill supplies know-how rather than render scripts. It tells the agent to break a problem into three layers: the full problem text with formulas in LaTeX, a solution chain of two to five atomic steps, and at most one common student mistake per step to flag in narration and on screen.

When should I use Math Tutorial Video Planner?

Math Tutorial Video Planner fits situations like: making a worked-solution video for a math problem; planning narration and scene timing for a Chinese math tutorial; laying out equation steps with highlighted results.

How do I install Math Tutorial Video Planner in Claude Code?

Run `npx skills add agentscope-ai/QwenPaw --skill edu-math-tutorial -a claude-code`. Or copy the skill folder (plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial in agentscope-ai/QwenPaw) into .claude/skills/edu-math-tutorial in your project. Claude Code loads it when a task matches its description.

How do I install Math Tutorial Video Planner in Codex?

Run `npx skills add agentscope-ai/QwenPaw --skill edu-math-tutorial -a codex`. Or copy the skill folder (plugins/apps/qwenpaw-creator/backend/skills/edu-math-tutorial in agentscope-ai/QwenPaw) into .agents/skills/edu-math-tutorial in your project. Codex loads it when a task matches its description.

Can I use Math Tutorial Video Planner 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 agentscope-ai/QwenPaw --skill edu-math-tutorial -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-math-tutorial, .gemini/skills/edu-math-tutorial, .github/skills/edu-math-tutorial and .opencode/skills/edu-math-tutorial in your project.

What does Math Tutorial Video Planner need to run?

SKILL.md names no scripts, command-line tools or credentials: Math Tutorial Video Planner is instructions for the agent only. Our summary lists: QwenPaw Creator with its motion_clip and audio elements.

Does Math Tutorial Video Planner 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 Math Tutorial Video Planner 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. Review the folder before installing.

What licence does Math Tutorial Video Planner use?

Math Tutorial Video Planner 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 Math Tutorial Video Planner use?

About 783 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Math Tutorial Video Planner?

Skills that share tags, products or a category with Math Tutorial Video Planner: Manim Video Production (browser-use/video-use, 28k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 65k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and AI Engineering Course Guide (rohitg00/ai-engineering-from-scratch, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Math Tutorial Video Planner?

agentscope-ai (a GitHub organization) maintains it in agentscope-ai/QwenPaw, which has 35,464 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 30, 2026.

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