vasanthsreeram/alvarmethod

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

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 

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

---

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:

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

flowchart LR
  A[Probeedge of this mind] --> B[Planmermaid DAG]
  B --> C[Teachone 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

Quizzes must use the native picker:

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/.md
.alvar/sessions/-.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.