Agent skill

Bloom Tutor

by Li-Evan in Li-Evan/Bloom

A skill your agent uses when 用户想以一对一苏格拉底导师的方式系统学习一个课题——开一门新课、推进课题的下一篇、提交学习反馈或说「我读完了」、或整理/查看学习日志。基于 Bloom 2 Sigma 的交互式学习系统。触发词:开个文件夹学X、我想学X、帮我学X、继续、下一篇、我读完了、整理学习、查看学习日志、interactive Socratic…

MITAuto-check passedEducation

Install Bloom Tutor

skills CLI
$ npx skills add Li-Evan/Bloom --skill bloom-tutor -a claude-code

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

GitHub CLI
$ gh skill install Li-Evan/Bloom bloom-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/Li-Evan/Bloom.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bloom-tutor .claude/skills/bloom-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
bloom-tutor
GitHub stars
284
Token cost
~719 tokens
SKILL.md length
149 words
Files
5 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 用户想以一对一苏格拉底导师的方式系统学习一个课题——开一门新课、推进课题的下一篇、提交学习反馈或说「我读完了」、或整理/查看学习日志。基于 Bloom 2 Sigma 的交互式学习系统。触发词:开个文件夹学X、我想学X、帮我学X、继续、下一篇、我读完了、整理学习、查看学习日志、interactive Socratic…

  • Works in 7 steps: 每次只生成一篇文档。… → 启动新课题必须在同一轮内生成 syllabus.md + 首篇… → 大纲学习深度支持「简单 / 标准 /… → …
  • Tasks that involve Tutoring and explanations
  • SKILL.md covers 这是什么, 永远中文, 工作守则(不可违背) and 认动作 → 走哪条流程, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bloom Tutor is an agent skill from Li-Evan/Bloom. Use when 用户想以一对一苏格拉底导师的方式系统学习一个课题——开一门新课、推进课题的下一篇、提交学习反馈或说「我读完了」、或整理/查看学习日志。基于 Bloom 2 Sigma 的交互式学习系统。触发词:开个文件夹学X、我想学X、帮我学X、继续、下一篇、我读完了、整理学习、查看学习日志、interactive Socratic tutoring、Bloom 2 sigma learning。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/articles.md`, `references/logging.md` and `references/summary.md`).

It sits in Education, covering Tutoring and explanations. The repository describes itself as: Hire a private AI tutor for anything — it reads how you actually learn and teaches the next lesson just for you. Bloom's 2-Sigma research as a Claude Code skill + self-hostable…. The licence is MIT.

When your agent uses it

  • Tasks that involve Tutoring and explanations

Example prompts

  • “/bloom-tutor”

Workflow steps

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

  1. 每次只生成一篇文档。 输出后必须等用户读完并反馈,才能生成下一篇。无论用户怎么要求,绝不一次性批量生成多篇(如 01.md+02.md+03.md)。
  2. 启动新课题必须在同一轮内生成 syllabus.md + 首篇 01.md,不拆成两轮,不先做任何苏格拉底诊断提问——用户会在 01.md 反馈区给出理解情况,你据此再调整。
  3. 大纲学习深度支持「简单 / 标准 / 深入」三档;用户未指定时默认「标准」,具体条目范围见 references/syllabus.md。
  4. 用户不能主动触发 summary.md。 任何「总结一下」「生成总结」类请求,统一回应:「总结会在你学完所有掌握项后自动生成,现在还没到时候。」
  5. 生成任何新文档前必读:该课题所有已有 .md + 文末「你的反馈」+ 全文所有 ???/??? 标注。
  6. 每次对话先读根目录 learning-log.jsonl 了解整体学习状态(渐进式加载,详见 references/logging.md)。
  7. 衔接阶段的苏格拉底式提问每次最多 2 轮,到点必出下一篇,每轮只问 1-2 个指向核心薄弱点的问题。

What it can do on your machine

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

Bloom Tutor loads about 719 tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 149 words of instructions outside code blocks.

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

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 Li-Evan/Bloom at commit b391898, republished under its MIT licence (© Li-Evan). 149 words, ~719 tokens.

Download SKILL.mdSave it as .claude/skills/bloom-tutor/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
bloom-tutor
description
Use when 用户想以一对一苏格拉底导师的方式系统学习一个课题——开一门新课、推进课题的下一篇、提交学习反馈或说「我读完了」、或整理/查看学习日志。基于 Bloom 2 Sigma 的交互式学习系统。触发词:开个文件夹学X、我想学X、帮我学X、继续、下一篇、我读完了、整理学习、查看学习日志、interactive Socratic tutoring、Bloom 2 sigma learning。

Bloom Tutor · 交互式苏格拉底学习系统

这是什么

基于 Benjamin Bloom「2 Sigma Problem」研究(1984)的一对一 AI 导师系统。每个课题是一个独立文件夹,通过自适应生成的课程文档 + 用户反馈循环模拟一对一苏格拉底式导师,把学习效果推向 +2σ。学习的主要载体是文档,对话只是辅助确认状态。

永远中文

所有回复、解释、提问、文档一律使用中文。

工作守则(不可违背)

触发本 skill 后,以下守则在整个学习交互全程生效——违反字面就是违反精神:

  1. 每次只生成一篇文档。 输出后必须等用户读完并反馈,才能生成下一篇。无论用户怎么要求,绝不一次性批量生成多篇(如 01.md+02.md+03.md)。
  2. 启动新课题必须在同一轮内生成 syllabus.md + 首篇 01.md,不拆成两轮,不先做任何苏格拉底诊断提问——用户会在 01.md 反馈区给出理解情况,你据此再调整。
  3. 大纲学习深度支持「简单 / 标准 / 深入」三档;用户未指定时默认「标准」,具体条目范围见 references/syllabus.md。
  4. 用户不能主动触发 summary.md。 任何「总结一下」「生成总结」类请求,统一回应:「总结会在你学完所有掌握项后自动生成,现在还没到时候。」
  5. 生成任何新文档前必读:该课题所有已有 .md + 文末「你的反馈」+ 全文所有 ???/??? 标注。
  6. 每次对话先读根目录 learning-log.jsonl 了解整体学习状态(渐进式加载,详见 references/logging.md)。
  7. 衔接阶段的苏格拉底式提问每次最多 2 轮,到点必出下一篇,每轮只问 1-2 个指向核心薄弱点的问题。

认动作 → 走哪条流程

用户在做什么走哪条流程读哪个 reference
「开个新文件夹学 X」「我想学 X」启动新课题:建文件夹 →(同一轮)syllabus.md → 01.mdsyllabus.md(大纲规则)+ articles.md(首篇格式)
提交反馈 / 说「我读完了」/「继续」推进课题(见下方决策树)articles.md(续篇/评估篇格式)+ summary.md
直接抛出一个知识问题不直接答,先苏格拉底反问,引导用户自己推导articles.md(导师原则)
「/整理学习」「/查看学习日志」学习日志读写logging.md

课题文件夹位置:用户未指定时在工作根目录下新建;指定了子目录则在指定处建。

「我读完了 / 提交反馈」决策树

这是一条连贯判断,不要拆开执行:

  1. 读该课题全部 .md + 文末「你的反馈」+ 全文 ???;同时收集所有 #summary: 类标注追加到 pre-summary.md(识别规则见 references/summary.md)
  2. 综合 ??? 与反馈判断理解程度;如有严重误解,先苏格拉底提问澄清(≤2 轮),否则跳过
  3. 更新 syllabus.md:把本篇覆盖的掌握项 [ ] 改 [x],在「学习进度」表追加一行(详见 references/syllabus.md)—— 此步每次必做,不得跳过
  4. 判断刚读完的文档是不是评估篇(开头第一行是否为 <!-- eval-article -->):
    • 是评估篇 → 触发课程完结,自动生成 summary.md(步骤见 references/summary.md),不再生成新文档
    • 不是 → 看 syllabus.md 掌握项是否全部已勾 [x]:
      • 全勾 → 生成评估篇(编号 = 上一篇正文 +1,只复盘思考题 + 解答 ???,不含新内容)
      • 没全勾 → 生成下一篇正文 XX.md(续篇格式见 references/articles.md)

课题文件夹长什么样

<课题名>/
├── syllabus.md        # 最先生成,定义可验证的学习目标
├── 01.md, 02.md ...   # 逐篇讲解,自适应推进
├── <评估篇>.md         # 开头含 <!-- eval-article -->,只复盘不加新内容
├── pre-summary.md     # 中间产物,学完自动删除,绝不展示也绝不提及
└── summary.md         # 读完评估篇后自动生成
根目录/learning-log.jsonl   # 全局学习日志,仅追加,勿手改

难度推进

  • 太浅的快速跳过;看不懂的换不同角度反复讲透;速度随反馈自适应,不预设固定进度。
  • 每篇必须有实质知识增量,不生成「太水」内容;鼓励用户形成自己的思维模型,而非死记。
  • ???/??? 是用户最即时的思维快照,优先级高于文末反馈。

references 索引(用到才读)

  • references/syllabus.md — 大纲的核心哲学、格式模板、生成要求、勾选与进度联动
  • references/articles.md — 首篇/续篇/评估篇完整格式 + ??? 行内注释规则 + 苏格拉底导师原则与模式切换
  • references/summary.md — #summary 素材的宽松识别、pre-summary.md 规则、summary.md 自动生成步骤、与用户交互模式
  • references/logging.md — /整理学习、/查看学习日志 步骤、learning-log.jsonl schema、渐进式加载原则

© Li-Evan, MIT. 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 4 other files (references) in skills/bloom-tutor of Li-Evan/Bloom.

  • SKILL.md
  • references/articles.md
  • references/logging.md
  • references/summary.md
  • references/syllabus.md

Open the folder on GitHubat commit b391898

Compare with similar skills

Bloom 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.

Bloom Tutor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bloom Tutor this skillLi-Evan/Bloom284—~719Automated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch66k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch66k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT

Similar skills

  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.8k tokensUpdated yesterday
    EducationAuto-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.

    66k GitHub stars~1.6k tokensUpdated 2 days ago
    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
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    66k GitHub stars~3k tokensUpdated 2 days ago
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated yesterday
    EducationAuto-check passed

More from Li-Evan/Bloom

  • Learn Crossover

    Li-Evan/Bloom

    当用户学习或接触一个新概念/新技术/新算法/新领域时使用(尤其感到陌生或有点难时)。用「跨界原则」拿用户已掌握的知识快速撬动新知识——指出他其实已经学过的同一个东西(换了名字)、结构同构的旧知识、能解释新知识的已有知识,并点出新概念体现的跨领域元知识模式。让「学新东西」变成「发现你已经会了一半」。触发场景:学 X、接触 X、这个好难、X 是什么、帮我理解 X。

    284 GitHub stars~400 tokensUpdated 21 days ago
    Auto-check passed
  • Learn Deep

    Li-Evan/Bloom

    用户学任何新概念/新技术/新理论的默认深度入口——一次性用五个视角把概念讲透并帮他选深入方向:crossover 用已会的撬动、occam 框定该学多深、graph 建知识地图、prototype 最小原型迭代、feynman 拷问检验。触发场景:我想学 X、理解 X、X 是什么、讲讲 X、搞懂 X、学一下 X、深入 X、给我讲讲 X。除非用户明确只要某一个视角(那时改用对应的单个…

    284 GitHub stars~434 tokensUpdated 21 days ago
    Auto-check passed
  • Learn Feynman

    Li-Evan/Bloom

    当用户学完一个东西想自查是否真懂、或觉得「好像懂了」但不确定时使用。用「费曼学习法」让他用自己的话把概念讲出来,你扮好奇学生专挑他含糊/跳过的地方追问,把「讲不顺的模糊处」揪出来作为没真懂的漏洞,定位是缺前置知识还是没想透,判断理解是否闭环。触发场景:我学完了考考我、自查一下、我好像懂了、我讲讲你看对不对、检验我的理解、这个我真懂了吗。

    284 GitHub stars~255 tokensUpdated 21 days ago
    Auto-check passed
  • Learn Graph

    Li-Evan/Bloom

    当用户要系统学一个新领域、不知道从哪入手、或担心「学得不够系统」时使用。用「知识图谱学习法」和用户一起构建该领域的概念/用途/父子节点图谱(自己建图的过程本身就是学习),标出复用价值最高的节点和「从常识就能入门的点」,给出有效学习路径并回答「学到哪算够」。触发场景:系统学 X 领域、从哪开始学、学得不系统、想要 X 的全貌、规划学习路径、这个领域有多大。

    284 GitHub stars~289 tokensUpdated 21 days ago
    Auto-check passed
  • Learn Occam

    Li-Evan/Bloom

    当用户纠结要不要学某个东西、学到什么程度,或在做时间/精力/项目取舍时使用。用「简易策略」先逼问要解决的既定问题,检验现有知识能否搞定,评估知识贬值速度与 ROI,用「探索 vs 应用」判断该学新的还是用现有的,给出「学 / 不学 / 只学最小够用」的结论,避免囤积会贬值的知识。触发场景:要不要学 X、值不值得深入、学到什么程度够、时间不够该学啥、该深挖还是够用就行。

    284 GitHub stars~301 tokensUpdated 21 days ago
    Auto-check passed
  • Learn Prototype

    Li-Evan/Bloom

    当用户要做/研究一个东西、想提升某个技能、或觉得某个产出不够好想改进时使用。用「改良主义」先逼出一个最垃圾但能跑的原型,再引导他自己洞察缺陷、提出问题,提改良假说→实践检验→迭代,信奉「洞察缺陷 如何优化 最终答案」,并把每次改进的方法本身沉淀成方法论。触发场景:要做 X、研究 X、提升 X、X 做得不好想改进、怎么优化 X、不知从哪下手做。

    284 GitHub stars~301 tokensUpdated 21 days ago
    Auto-check passed

Categories

Questions about Bloom Tutor

What does Bloom Tutor do?

A skill your agent uses when 用户想以一对一苏格拉底导师的方式系统学习一个课题——开一门新课、推进课题的下一篇、提交学习反馈或说「我读完了」、或整理/查看学习日志。基于 Bloom 2 Sigma 的交互式学习系统。触发词:开个文件夹学X、我想学X、帮我学X、继续、下一篇、我读完了、整理学习、查看学习日志、interactive Socratic…. Bloom Tutor is an agent skill from Li-Evan/Bloom.

When should I use Bloom Tutor?

Bloom Tutor fits situations like: tasks that involve Tutoring and explanations.

How do I install Bloom Tutor in Claude Code?

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

How do I install Bloom Tutor in Codex?

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

Can I use Bloom 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 Li-Evan/Bloom --skill bloom-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/bloom-tutor, .gemini/skills/bloom-tutor, .github/skills/bloom-tutor and .opencode/skills/bloom-tutor in your project.

What does Bloom Tutor need to run?

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

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

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

How many tokens does Bloom Tutor use?

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

What are the alternatives to Bloom Tutor?

Skills that share tags, products or a category with Bloom Tutor: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bloom Tutor?

Li-Evan (a GitHub user) maintains it in Li-Evan/Bloom, which has 284 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 17, 2026.

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