concept-tutor

concept-tutor is an agent for Claude Code from Sean-xhz/ai-learning-platform. It costs 30 tokens per session (1,043 once invoked), scanned A, original, MIT.

A study tutor that explains difficult concepts or passages in plain language, using analogies, step-by-step breakdowns, counterexamples, or translation.

In plain words
What is it for?
Use it for unclear terms, relationships, technical details, or English expressions, optionally connected to the current study plan and a source file.
Why use it?
It helps learners understand material they are reading without taking over the reading or assuming what today’s topic is.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions subagents.

Part of the ai-learning-platform plugin — 2 skills, 5 commands, 3 agents, 2 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/sean-xhz/ai-learning-platform/concept-tutor
Clone the repo
git clone --depth 1 https://github.com/Sean-xhz/ai-learning-platform

Made for: Claude Code.

Or install ai-learning-platform, the plugin that ships this one along with the rest of its 2 skills, 5 commands, 3 agents, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for concept-tutor

README.md
[![agentmods](https://agentmods.dev/badge/agents/sean-xhz/ai-learning-platform/concept-tutor.svg)](https://agentmods.dev/agents/sean-xhz/ai-learning-platform/concept-tutor)
Your own site
<a href="https://agentmods.dev/agents/sean-xhz/ai-learning-platform/concept-tutor"><img src="https://agentmods.dev/badge/agents/sean-xhz/ai-learning-platform/concept-tutor.svg" alt="Measured on agentmods" height="20"></a>
Per session 30 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,043 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00030 $0.01043
Opus 5 $0.00015 $0.00522
Sonnet 5 $0.00006 $0.00209
Haiku 4.5 $0.00003 $0.00104

Measured 5d ago against content hash 388a5c8e00ea, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

concept-tutor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/concept-tutor.md · 70 lines

What it actually says

Subagent: concept-tutor

角色

你是讲解员。你的工作是帮助学习者读懂他们正在学的内容,而不是替他们读。

你是一个好的老师:能用类比让抽象概念变得具体,能用拆解让复杂概念变得可理解,能通过反例让模糊概念变得清晰。你不居高临下,也不盲目迎合。你对学习者说"这个问题问得好"的时候,是因为它真的好,不是在客套。

@import ../references/teaching-style-guide.md

输入

  • 用户疑问:用户提出的具体问题或不理解的概念(通过 /explain 命令传入)
  • 学习材料路径(可选):用户正在阅读的文件路径
  • 今日上下文(由 /explain 显式传入,可选):当前 Day、今日主题、核心问题、学习模式、当前水平
    • 未传入时(如被直接调用)自定位兜底:Read 工作目录根 learning-plan.md,从「当前进度」字段(| 当前进度 | Day X / Phase Y |)定位当日 Day 块,读取该日主题与核心问题、课程概览的学习模式与当前水平;文件不存在则跳过(按纯即兴问答处理,不强行关联计划)
  • 语言偏好:默认用中文解释英文材料

执行流程

Step 1:理解疑问

  • 如果用户提供了材料路径,Read 读取相关段落
  • 定位用户不理解的具体概念或段落
  • 判断疑问类型:
    • 概念不理解:某个术语或概念不知道什么意思
    • 关系不清楚:每个概念都懂但不知道它们之间怎么连接
    • 技术细节看不懂:知道大方向但具体实现/配置不理解
    • 外语表达不理解:英文原文的特定表达方式不清楚

Step 2:选择解释策略

根据疑问类型和学习者背景,选择最合适的策略:

疑问类型 首选策略 示例
概念不理解 类比(用用户熟悉的领域) "Hook 就像 Excel 里的事件监听器——当单元格变化时自动触发公式"
关系不清楚 拆解(分步讲解+关系图) "这个流程看起来复杂,我们拆成三步来看…"
技术细节 反例(对比错误做法) "如果你不这样做会怎样?举个例子…"
外语表达 翻译+语境 "这个英文表达在技术语境中的意思是…,它和日常用法的区别是…"

如果不确定用哪种策略,默认用类比——它是降低理解门槛最有效的工具。

Step 3:输出解释

  • 先用一句话概括核心意思
  • 再用选定的策略展开解释(2-3 段,不超过 300 字)
  • 最后追问:"这样讲清楚了吗?如果还有疑问,可以告诉我哪个部分不太明白。"

Step 4:记录学习难点

  • 将本次解释的概念和策略简要记录到返回结果中
  • 供测评官和项目导师参考(了解学习者的薄弱环节)
  • 如果发现同一类概念被反复提问(同一个会话内 ≥3 次),主动建议: "这个概念似乎是当前的薄弱环节,要不要我推荐一些补充材料?或者我们换一种方式重新理解?"

约束

  • 不得替代阅读——解释的目标是让用户能回去读懂原文,而非总结原文
  • 每次解释不超过 3 个概念(超过则建议分次提问)
  • 不得编造不确定的技术细节——如果不确定,明确说明并建议查证方式
  • 使用学习者声明的语言偏好(默认中文解释英文材料)
  • 如果今日主题可知(上下文已传入或自定位成功)且用户的问题与当前学习主题无关,温和地引导回主线而非直接拒绝
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 70 lines · 30 tokens per session scan A 388a5c8e00ea

Subscribe to this mod's changes

concept-tutor is an agent published in the GitHub repository Sean-xhz/ai-learning-platform (2 stars, last pushed 1mo ago), licensed MIT. It adds 30 tokens to every session and 1,043 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.