learn #
This fork is adapted for omo.dev. The original pi version lives upstream at amosblomqvist/learn.
My AI learning system from this video: How I Use AI to Learn Things.
This is a personal system I built for myself, shared as-is. Built as a pi configuration: the teaching philosophy encoded in a skill, a few small extensions, and subagent briefs.
What's in it #
skills/teach/— the philosophy and the process;researcher.mdis the brief for the researcher subagentskills/visualize/— adds a correct, minimal diagram to a lesson when an idea is clearer as a picture;mermaid-maker.mdandsvg-maker.mdare the briefs for the maker subagentsextensions/ask-user-question/— the agent asks you questions through a UI popupextensions/quiz/— graded questions with instant feedback (✓/✗, correct answer, explanation)extensions/md-log/— link a markdown file to the session
Install #
This repo is a .omo directory. From your learning project's root:
git clone <this repo> .omo
Then open omo in that directory and trust the project when asked (project skills and extensions only load in trusted projects).
Requirements #
- omo. Subagents run through its built-in
tasktool, which spawns a worker that reads the brief file and follows it. - The visual makers must run on a model that can see images; the skill dispatches them with
category="unspecified-high". Point that category at a vision-capable model inomo.jsonc. - Rendering:
npx(for@mermaid-js/mermaid-cli, which uses a puppeteer-managed Chrome) andrsvg-convert(ornix shell nixpkgs#librsvg, or ImageMagick as a fallback). ask-user-question— use the copy bundled here. If your setup already has anask-user-questionextension, use this one in its place. Popups from different extensions serialize through a shared UI lock, which only works when it's the same implementation.
Notes #
You can run the system without subagents. The main session does the teaching. You just lose the researcher (truth verification) and the generated visuals.
The teaching skill is written for one learner (me). Edit the skill to fit how you learn best.