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 — это переносимый набор навыков ИИ-агентов, реализующий учебный цикл ИИ «один на один» от Eero Alvar (прощупать, спланировать, обучить) внутри вашего существующего кодинг-агента, превращая его в персонального репетитора по любой теме, которую вы добавите в папку обучения.
Это отдельное приложение или то, что я устанавливаю в своего ИИ-агента?Это не отдельное приложение. Это набор Agent Skills (файлы SKILL.md), которые копируются в папку навыков агентов, которыми вы уже пользуетесь, например Claude Code или Codex.
Какие кодинг-агенты поддерживаются?Поддерживаются Codex, Claude Code, Grok, Pi, OpenCode, Cursor и другие агенты, совместимые с skills-CLI, у каждого свой глобальный путь установки (например, ~/.claude/skills для Claude Code, ~/.codex/skills для Codex).
Интерфейс квиза всегда работает правильно?Это зависит от того, правильно ли агент вызывает свой встроенный выбор вопросов (askuserquestion, AskUserQuestion, question или quiz/askuser); если агент вместо этого вставляет простой текст A/B/C/D или вываливает весь урок целиком, приходится вручную просить его «использовать инструмент квиза» или держаться одного узла.
Как им пользоваться после установки?Откройте папку обучения (не этот репозиторий) и попросите агента вас обучить; он должен ответить выбором вопроса в квизе, затем mermaid-диаграммой темы, одним шагом рассуждения и финальным закрепляющим квизом.
Какие навыки входят в набор?Пять навыков: 'teach' запускает полный цикл прощупать-спланировать-обучить, 'probe' просто картирует ваше понимание, 'learn-profile' пишет файл профиля учащегося, 'learn-visual' генерирует один правимый SVG-план, а 'learn-verify' проверяет утверждение по фактам прежде, чем его обучат.
Зачем это создано, если можно просто болтать с ИИ и учиться?Автор считает открытое обучение «многие-ко-многим» (один учитель на много учеников или один ученик, прыгающий между многими источниками) расточительным и недостоверным; этот набор исправляет это единым интерфейсом, продуманным доверием и одним шагом обучения за раз, чтобы усилия оставались в материале, а не в логистике.
Где сохраняются мои учебные сессии?Файлы сессий записываются в папку .alvar/ внутри вашего каталога обучения, и можно направить Obsidian на эту папку, если хотите предпросмотр заметок с LaTeX.
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