Alvarmethod README

The project's README from github.com/vasanthsreeram/Alvarmethod. As one markdown file: README.md.

Alvarmethod — probe, plan, teach

One teacher. One mind.
Portable agent skills that run Eero Alvar’s AI learning loop.

stars MIT Agent Skills Eero Alvar 

npx skills add vasanthsreeram/Alvarmethod -g --all

That’s the install. Works in Claude Code, Codex, Grok, Pi, OpenCode, Cursor, and the rest of the skills CLI agents.

Then open a learning folder (not this repo) and say:

/teach I want a solid introduction to <topic>

You should get a quiz picker (not A/B/C/D in chat) → a mermaid DAG → one reasoning step → a lock-in quiz.

Quick install

npx skills (preferred)

The open skills CLI. Discovers every skills/*/SKILL.md in this repo.

# global, every detected agent, no prompts
npx skills add vasanthsreeram/Alvarmethod -g --all

# list what’s in the pack
npx skills add vasanthsreeram/Alvarmethod --list

# one skill
npx skills add vasanthsreeram/Alvarmethod --skill teach -g -y

# one harness
npx skills add vasanthsreeram/Alvarmethod -g -y -a claude-code -a grok -a pi -a opencode -a codex

Update later:

npx skills update -g

npx this repo

No extra CLI — runs install.sh from GitHub:

npx github:vasanthsreeram/Alvarmethod
npx github:vasanthsreeram/Alvarmethod --list
npx github:vasanthsreeram/Alvarmethod --claude --grok

Clone

git clone https://github.com/vasanthsreeram/Alvarmethod.git
cd Alvarmethod
./install.sh          # all known agent dirs
./install.sh --project
./install.sh --uninstall
Agent Global path
Codex ~/.codex/skills + ~/.agents/skills
Claude Code ~/.claude/skills
Grok ~/.grok/skills
Pi ~/.pi/agent/skills
OpenCode ~/.config/opencode/skills

The method

Credit: Eero Alvar — How I Use AI to Learn Things (2026-08-14). This pack implements that loop as Agent Skills. It is not his original Pi quiz / Obsidian setup. Captions: source/eero-alvar-how-i-use-ai-to-learn-things.md.

Many-to-many learning leaks:

Direction Waste
One outlet → many students Never fitted to your edge
One student → many outlets Switching cost + the brain hedges on sources it does not trust

Fix: one interface, many sources. Trust is engineered (verify). Struggle stays in the material. The system eats logistics.

flowchart LR
  A[Probe<br/>edge of this mind] --> B[Plan<br/>mermaid DAG]
  B --> C[Teach<br/>one node]
  C --> D[Lock-in quiz]
  D -->|pass| C
  D -->|fail| E[Insert prereq]
  E --> C
  1. Probe — graded MCQ in the harness picker, start wide, binary-search every strand
  2. Plan — mermaid DAG for this mind, shown before teaching
  3. Teach — one reasoning step, picture if needed, quiz, next node

Skills

Skill Job
teach Full loop: probe → plan → one-step teaching
probe Understanding map only
learn-profile Write .alvar/LEARNER.md
learn-visual One SVG, look at it, fix it
learn-verify Fact-check a claim before it is taught as fact

Quizzes must use the native picker:

Agent Tool
Grok / Codex ask_user_question
Claude Code AskUserQuestion
OpenCode question
Pi quiz / ask_user / askUserQuestion

If the agent pastes A/B/C/D, say “use the quiz tool.” If it dumps a textbook, say “one node only.”

Session files land in the learning folder:

.alvar/LEARNER.md
.alvar/maps/<topic>.md
.alvar/sessions/<date>-<topic>.md
.alvar/visuals/…

Point Obsidian at .alvar/ if you want LaTeX preview.

Contributing

See CONTRIBUTING.md. Edit skills here, then reinstall. Don’t patch the copies under ~/.claude / ~/.grok.

License

MIT for the skills, installer, and docs.

The video and spoken method are Eero Alvar’s. Watch the original: youtu.be/kzcI5F4tGiU.

Alvarmethod (vasanthsreeram/Alvarmethod)

Searching Database…

162 ·GitHub
Alvarmethod
这是什么？Alvarmethod 是一个可移植的 AI agent 技能包，在你现有的 coding agent 内实现 Eero Alvar 的一对一 AI 教学循环（探测、规划、教学），把它变成一位私人导师，可以教你添加到学习文件夹里的任何主题。
这是个独立应用，还是装进我的 AI agent 里的东西？它不是独立应用。它是一组 Agent Skills（SKILL.md 文件），复制进你已经在用的 agent（比如 Claude Code 或 Codex）的 skills 文件夹即可。
支持哪些 coding agent？支持 Codex、Claude Code、Grok、Pi、OpenCode、Cursor 以及其他与 skills-CLI 兼容的 agent，每个都有自己的全局安装路径（例如 Claude Code 是 ~/.claude/skills，Codex 是 ~/.codex/skills）。
测验 UI 总能正常工作吗？这取决于 agent 能否正确调用其原生的问题选择器（askuserquestion、AskUserQuestion、question 或 quiz/askuser）；如果 agent 只是粘贴普通的 A/B/C/D 文本或一次性倒出整节课内容，你就得手动让它「使用测验工具」或坚持单个节点。
装好之后实际怎么用？打开一个学习文件夹（不是这个仓库），让 agent 教你；它应该先给出一个测验选择器，然后是这个主题的 mermaid 图、一步推理，以及最后的巩固测验。
这个技能包含哪些技能？五个技能：'teach' 运行完整的探测-规划-教学循环，'probe' 只梳理你的理解程度，'learn-profile' 写一个学习者画像文件，'learn-visual' 生成一张可修改的 SVG 图，'learn-verify' 在讲授之前对论断做事实核查。
为什么造这个，而不是直接跟 AI 聊天学习？作者认为开放式多对多学习（一个老师对多个学生，或一个学生在多个信源之间跳来跳去）既浪费又不可信；这个技能包用统一界面、精心设计的可信机制和一次只教一步来解决这个问题，让「卡壳」留在学习材料本身，而不是流程折腾上。
我的学习会话保存在哪里？会话文件写进学习目录里的 .alvar/ 文件夹，如果你想让笔记带 LaTeX 预览，可以把 Obsidian 指向那个文件夹。
What are similar projects?nuwa-skill, pstack, pstack-claude, Waza, agents, draw-architecture, zhangxuefeng-skill, hello-sdd
Which topics is it in?npx, opencode, skill, cursor, shell, agentic-ai, claude, learning, agent-skills, codex, claude-code, education
Creator
vasanthsreeram
Size
<0.1 MB
Stars
162
Updated
CommitAug 16
Age
2mo
Commits · 90 Days