Agent skill

Student Tutor

by digoal in digoal/blog

给学生用其所在年级听得懂的语言通俗讲解题目,并生成举一反三练习。当用户给出年级 + 题目(文字或图片)希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件:讲解文件与配套练习文件。

GPL-2.0Auto-check passedDocuments & Office

Install Student Tutor

skills CLI
$ npx skills add digoal/blog --skill student-tutor -a claude-code

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

GitHub CLI
$ gh skill install digoal/blog student-tutor --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/student-tutor .claude/skills/student-tutor && 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
student-tutor
GitHub stars
8.6k
Token cost
~844 tokens
SKILL.md length
158 words
Files
4 (incl. references)
Skills in repo
98
Repo updated
First seen
Licence
GPL-2.0

At a glance

给学生用其所在年级听得懂的语言通俗讲解题目,并生成举一反三练习。当用户给出年级 + 题目(文字或图片)希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件:讲解文件与配套练习文件。

  • Works in 8 steps: 确认输入 → 必须拿到:①年级 ②题目。题目可能是文字,也可能是图片。 → 读题 → 若题目是图片,用 mcpMiniMaxunderstand_image… → 定年级语言基线 → 阅读… → …
  • Tasks that involve Markdown
  • SKILL.md covers 目的, 工作流程, 第一步:确认输入 and 讲解结构(讲解文件内容), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Student Tutor is an agent skill from digoal/blog. 给学生用其所在年级听得懂的语言通俗讲解题目,并生成举一反三练习。当用户给出年级 + 题目(文字或图片)希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件:讲解文件与配套练习文件。

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/examples.md` and `references/grade_levels.md`).

It sits in Documents & Office, covering Markdown. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “讲到孩子能听懂”
  • “/student-tutor”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 确认输入 → 必须拿到:①年级 ②题目。题目可能是文字,也可能是图片。
  2. 读题 → 若题目是图片,用 mcpMiniMaxunderstand_image 提取题目文字与图中信息(数字、图形、表格、坐标等),并在心里复述确认题意。
  3. 定年级语言基线 → 阅读 references/grade_levels.md,按年级锁定可用词汇、可用知识点、禁用超纲方法。
  4. 解题与讲解 → 先自己算出正确答案(必要时多种解法都算一遍),再按下方"讲解结构"组织内容。
  5. 出举一反三题 → 3~5 道同类/变式题,难度由易到难,覆盖同一知识点的不同侧面。
  6. 写两个文件 → 讲解文件 + 练习文件(含答案与详细过程),写入 markdown/。
  7. 关键处配图 → 仅在"讲清楚某一步的关键"时用一张 mermaid 或 svg 图,不滥用。
  8. 自检 → 对照"质量自检清单"逐项核对后再交付。

What it can do on your machine

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

Student Tutor loads about 844 tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 158 words of instructions outside code blocks.

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

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 digoal/blog at commit ad6fcb7, republished under its GPL-2.0 licence (© digoal). 158 words, ~844 tokens.

Download SKILL.mdSave it as .claude/skills/student-tutor/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
student-tutor
description
给学生用其所在年级听得懂的语言通俗讲解题目,并生成举一反三练习。当用户给出年级 + 题目(文字或图片)希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件:讲解文件与配套练习文件。

学生通俗讲解辅导

目的

把一道题,用指定年级的学生真正听得懂的语言讲清楚;多解法时按"启发思维"优先级排序讲解;再出几道同类题,把答案和详细过程写进单独的练习文件。

工作流程

  1. 确认输入 → 必须拿到:①年级 ②题目。题目可能是文字,也可能是图片。
  2. 读题 → 若题目是图片,用 mcp__MiniMax__understand_image 提取题目文字与图中信息(数字、图形、表格、坐标等),并在心里复述确认题意。
  3. 定年级语言基线 → 阅读 references/grade_levels.md,按年级锁定可用词汇、可用知识点、禁用超纲方法。
  4. 解题与讲解 → 先自己算出正确答案(必要时多种解法都算一遍),再按下方"讲解结构"组织内容。
  5. 出举一反三题 → 3~5 道同类/变式题,难度由易到难,覆盖同一知识点的不同侧面。
  6. 写两个文件 → 讲解文件 + 练习文件(含答案与详细过程),写入 markdown/。
  7. 关键处配图 → 仅在"讲清楚某一步的关键"时用一张 mermaid 或 svg 图,不滥用。
  8. 自检 → 对照"质量自检清单"逐项核对后再交付。

第一步:确认输入

如果用户没给年级,必须先问,不要猜——同一道题给三年级和初二讲法完全不同。 如果只有图片没有文字说明,先用 mcp__MiniMax__understand_image 读图,再向用户复述一句"我看到的题目是……,对吗?"式确认(除非题意非常清晰可直接开讲)。

读图调用示例:

mcp__MiniMax__understand_image(
  prompt="提取这张图里的完整题目:包括所有文字、数字、图形结构、表格数据、已知条件和要求。如果是几何图请描述各点、边、角的关系。",
  image_source="/abs/path/to/题目.png"   # 去掉用户路径里可能的 @ 前缀
)

讲解结构(讲解文件内容)

按以下顺序组织,用词必须落在该年级基线内(见 references/grade_levels.md):

  1. 题目 — 原样抄录题目(图片题则写出读取到的题目)。
  2. 先读懂题在问什么 — 用大白话翻译题目,点出"已知什么、求什么"。低年级可用生活化比喻。
  3. 解法(按启发思维优先级排序) — 关键要求:
    • 若有多种解法,最能启发思维、最贴近学生已有直觉的解法放第一个(如画图法、列举法、找规律),技巧性强/套公式的解法放后面。
    • 每种解法标注 ### 解法一:xxx(推荐先理解这种),并一句话说明"这种方法好在哪、为什么先讲它"。
    • 每一步都要讲为什么这么做,而不只是"怎么算"。关键步骤给出算式。
  4. 答案 — 用醒目方式给出最终答案。
  5. 最容易犯的错误(必须详细讲解,不能只列点) — 这是讲解文件的重点部分之一,见下方"易错点详解"。
  6. 这道题考的知识点 — 一句话点明,连接到练习文件。

排序原则:直观/可视化/可动手的方法 > 通用方法 > 技巧/公式型方法。让学生先"懂道理",再"会套路"。

易错点详解(重点要求)

"容易错在哪"不能只写一句"别忘了通分"就完事。学生看不懂自己为什么会错,下次还会犯同样的错。

先预判该年级学生在这道题上最可能犯的 1~3 个错(结合年级基线想:他们会混淆什么、会想当然地套用什么、会漏掉哪一步)。挑出其中最容易犯、最典型的那一个,写成完整一段详细讲解,其余的可较简略。

每个易错点(尤其是最典型那个)按这四步写清楚,缺一不可:

  1. 错法长什么样 — 直接写出错误的算式/做法/答案,让学生一眼认出"这就是我会写的"。
  2. 为什么会这么想 — 点破背后的错误直觉或思维定式(比如"以为分数像整数一样分子分母分开加""把周长当成面积")。这是关键:只有说中他心里那个"想当然",他才会被点醒。
  3. 为什么是错的 — 用该年级听得懂的方式说明它错在哪,最好用具体数字、画图或反例验证给他看(如代入数字一算就发现不对)。
  4. 正确该怎么做 / 怎么避免 — 给出正确做法,并教一个能防住这个错的小习惯或自检办法(如"加分数前先问自己:分母一样了吗?")。

正确答案旁若能顺手对比"正确 vs 错误"两种结果,对比着讲会更醒目。

举一反三(练习文件内容)

  • 3~5 道题,只考同一个或紧密相关的知识点,难度递增(基础→变式→稍有挑战)。
  • 每道题给出:完整答案 + 详细解题过程(过程详尽程度等同讲解文件,让学生能独立看懂)。
  • 练习文件结构:先集中列出所有"题目",再给"参考答案与详解",便于学生先自测再对答案。

输出文件

写入当前项目的 markdown/ 目录(不存在则创建)。两个文件:

  • 讲解文件:markdown/<英文短名>-讲解.md
  • 练习文件:markdown/<英文短名>-练习.md

<英文短名> 用简短英文描述题目主题(如 fraction-addition、newton-second-law)。两文件互相在开头用相对链接引用对方。

配图规则(少而精)

只有当"一张图能让某个关键步骤瞬间清楚"时才配图,每个文件通常 0~2 张。

  • 优先 mermaid:流程、步骤、分类、关系、简单坐标逻辑——直接写进 Markdown 代码块。
  • 需要精确几何/函数图象/示意图时用 SVG:
    • SVG 文件存到 markdown/svg/<英文图片名>.svg(目录不存在则创建)。
    • 文中用 ![图片描述](svg/<英文图片名>.svg) 引用(注意:相对 markdown/ 目录的路径,所以是 svg/... 而非 markdown/svg/...)。
    • SVG 要自带文字标注(点名、数值、单位),保证不依赖正文也能看懂。

不要为了配图而配图。纯计算题往往一张图都不需要。

质量自检清单

交付前逐项核对:

  • 已确认年级;全文用词、方法都在该年级基线内,无超纲。
  • 答案是自己算过的,正确。多解法时各解法答案一致。
  • 多解法已按"启发思维"优先级排序,且说明了为什么先讲它。
  • 每步讲了"为什么",不是只有"怎么算"。
  • 最典型的易错点已按"错法→为什么这么想→为什么错→怎么避免"四步详细讲解(不是只列一句话)。
  • 练习题只考同知识点、难度递增;每题有完整答案+详细过程。
  • 两个文件都已写入 markdown/,并互相引用。
  • 配图(如有)确实服务于关键步骤;SVG 存于 markdown/svg/ 且用 svg/xxx.svg 引用。

资源

  • references/grade_levels.md — 各年级的语言风格、可用知识点、讲解策略与禁用项。每次讲解前必读对应年级段。
  • references/examples.md — 一个完整的输入→输出范例(讲解文件 + 练习文件 + mermaid 用法),动笔前可参考其结构与详尽程度。

© digoal, GPL-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 3 other files (references) in skills/student-tutor of digoal/blog.

  • SKILL.md
  • agents/openai.yaml
  • references/examples.md
  • references/grade_levels.md

Open the folder on GitHubat commit ad6fcb7

Compare with similar skills

Student Tutor 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.

Student Tutor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Student Tutor this skilldigoal/blog8.6k—~844Automated safety check: PassGPL-2.0
Gbro Series Vocabpyang5166/gbro-series-vocab162—~1.1kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Gbro Series Vocab

    pyang5166/gbro-series-vocab

    追剧学英语 / Learn English vocabulary from TV series. An agent skill from pyang5166/gbro-series-vocab.

    162 GitHub stars~1.1k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed

More from digoal/blog

All 98 skills in this repo
  • 三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…

    8.6k GitHub stars~939 tokensUpdated today
    Auto-check passed
  • Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…

    8.6k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Digoal

    digoal/blog

    Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…

    8.6k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

    8.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…

    8.6k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.

    8.6k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Student Tutor

What does Student Tutor do?

给学生用其所在年级听得懂的语言通俗讲解题目,并生成举一反三练习。当用户给出年级 + 题目(文字或图片)希望得到讲解、辅导、"讲到孩子能听懂"、出同类练习题时使用。覆盖小学到高中的数学、物理、化学、语文、英语、生物等学科。输出为当前项目 markdown/ 目录下的两个 Markdown 文件:讲解文件与配套练习文件。. Student Tutor is an agent skill from digoal/blog.

When should I use Student Tutor?

Student Tutor fits situations like: tasks that involve Markdown.

How do I install Student Tutor in Claude Code?

Run `npx skills add digoal/blog --skill student-tutor -a claude-code`. Or copy the skill folder (skills/student-tutor in digoal/blog) into .claude/skills/student-tutor in your project. Claude Code loads it when a task matches its description.

How do I install Student Tutor in Codex?

Run `npx skills add digoal/blog --skill student-tutor -a codex`. Or copy the skill folder (skills/student-tutor in digoal/blog) into .agents/skills/student-tutor in your project. Codex loads it when a task matches its description.

Can I use Student Tutor 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 digoal/blog --skill student-tutor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/student-tutor, .gemini/skills/student-tutor, .github/skills/student-tutor and .opencode/skills/student-tutor in your project.

What does Student Tutor need to run?

SKILL.md names no scripts, command-line tools or credentials: Student Tutor is instructions for the agent only.

Does Student Tutor 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 Student Tutor 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 Student Tutor use?

Student Tutor is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Student Tutor use?

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

What are the alternatives to Student Tutor?

Skills that share tags, products or a category with Student Tutor: Gbro Series Vocab (pyang5166/gbro-series-vocab, 162 stars), Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars) and Markitdown (ImCa0/just-laws, 782 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Student Tutor?

digoal (a GitHub user) maintains it in digoal/blog, which has 8,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 2026.

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