amosblomqvist's Learning System
This is a fork of https://github.com/amosblomqvist/learn that works with any coding harness — adapted from the personal AI learning system featured in the video How I Use AI to Learn Things.
Works seamlessly with any AI coding agent harness:
- OpenCode (
opencode) - Pi (
pi) - Claude Code (
claude) - Cursor / Codex / Windsurf / Aider / Any CLI Agent
skills/teach/: The core teaching philosophy (unconditional truths first, "how could I have discovered this?", Socratic edge-probing, calibrated checks).skills/visualize/: Minimal, verified diagrams (Mermaid for structure/relationships, SVG for spatial/geometry).agents/: Specialist subagents (researcher,mermaid-maker,svg-maker).scripts/: Harness-agnostic CLI utilities:node scripts/viz.js doctor— check diagram renderers.node scripts/viz.js render mermaid|svg ...— render and publish visuals.node scripts/learn-log.js link|status|append|unlink— mirror sessions to Obsidian.
- Obsidian Integration: Renders LaTeX math natively (
$f(x)$), resolves visual embeds (![[viz-...png|500]]), and formats lesson history using clean Obsidian callouts.
cd learning-agent
bun install --cwd .opencode # optional; opencode does this at startup
opencodeInside OpenCode:
/learn <topic>
To link an Obsidian lesson log:
/md-log lessons/my-lesson.md
You can either run pi directly in this repo or clone it as your project's .pi directory:
Option A: Run inside this directory
cd learning-agent
piPi automatically discovers .pi/ (which links to the extensions, agents, and skills) or .agents/skills/.
Option B: Clone as .pi in an existing vault/project
cd "/path/to/Obsidian Vault/MyProject"
git clone https://github.com/StrangeSid/learn-oc .pi
piInside Pi:
/skill:teach
Or start learning any topic directly.
cd learning-agent
claudeInside Claude Code:
/learn <topic>
To link an Obsidian lesson log:
/md-log lessons/my-lesson.md
Claude Code automatically reads CLAUDE.md, discovers slash commands from .claude/commands/, and uses scripts/viz.js and scripts/learn-log.js for rendering and log mirroring.
Open this directory in your agent or editor. The harness will automatically pick up AGENTS.md and .agents/skills/teach/SKILL.md.
Ask:
Teach me <topic>
- SVG Diagrams:
rsvg-convert(preferred) or ImageMagickmagick.
On macOS:brew install librsvg - Mermaid Diagrams:
@mermaid-js/mermaid-cli(mmdc) + Google Chrome or Chromium.
Runnode scripts/viz.js doctoranytime to check your setup:node scripts/viz.js doctor
- Obsidian: The lesson log (
lessons/or any markdown file in your vault) renders best in Obsidian, where LaTeX math and![[viz-...png|500]]wikilink embeds display inline. Keepviz/inside your vault so embeds resolve automatically.
- Probe: Fast calibrated checks bracket the learner's frontier on every foundation supporting the goal. Graded immediately.
- Plan: Verify facts, build a topological dependency map (roots = unconditional truths, sink = goal), present a small Mermaid diagram, and get the learner's go-ahead.
- Teach Loop: For each node:
- Motivate (why was this necessary?)
- Establish (clear, caveat-free truth)
- Connect (link explicitly to previous nodes)
- Quiz-check (confirm it landed before building on it)
- Visualize: When an idea genuinely needs a picture, the system authors it, renders it, visually inspects the PNG for errors, and embeds the verified image.
- Log: When linked, every teaching turn is cleanly preserved in Obsidian callout format.
Teaching philosophy, pedagogy, skills, agents, and visual-tools architecture originally created by Amos Blomqvist.