AI teacher

.md
agent layeragent/

Studying alone fails at the same point: nobody tells you what you got wrong. The agent plays the teacher. It explains from what you already know, asks before it tells, grades against a rubric and writes down your mistakes so the next exercise and exam press on them.

It never replaces the work. You read, you answer, you produce. It gives feedback.

Key terms

LLM
a language model. Reads text, writes text. Claude, GPT, Gemini, or a local one via Ollama
agent
an LLM that can use tools: read and write files, search the web, run commands. Claude Code, Codex, Gemini CLI, opencode. You talk to it in the third window
skill
a Markdown file with instructions for one job, in the Agent Skills format: name + description frontmatter, steps below. The agent loads it when you call it or when your request matches its description

What the teacher does

role skill
measures your level slp-quiz, slp-teach
explains, node by node slp-teach
condenses your material slp-summarize
builds exams and exercises slp-exam, slp-exercises
grades and gives feedback slp-grade
turns your notes into flashcards slp-cards
reads your sessions and says what's next slp-session
verifies before stating researcher

Everything it writes is plain JSON and Markdown, so you can write any of it by hand: a topic, notes, cards, an exam, an exercise. The skills guide the process. What needs the agent is the judgment: teaching, grading, reading your sessions, keeping the wiki.

Memory

The agent keeps no memory between sessions. The topic folder is the memory: learning.md holds what you've shown and what you got wrong, progress/ holds where you are and every study session, wiki/ holds the map of the subject. Every skill reads them before writing.

Wiki

Each topic has a wiki/: the agent's own map of the subject, an OKF bundle in the llm-wiki pattern. One page per concept with what it depends on and its sources, one page per source, and an index. slp-teach, slp-summarize and slp-session write it; slp-teach reads it to plan a lesson, and slp-exam, slp-exercises and slp-quiz draw on it. The only thing it records about you is which sessions studied each concept. The app doesn't show it. Format: wiki/.

Agents

researcher
verifies a fact or maps a topic, with sources. Shared by every topic
teacher-<slug>
one per topic, offered by slp-init. A persona the agent adopts while teaching: who would teach that subject in real life

Markdown formats

The documentation is also available in llms.txt formats:

  • llms.txt lists every documentation page.
  • llms-full.txt contains the complete documentation in one file and may exceed some context windows.

Append .md to any documentation URL to retrieve that page as Markdown. For example, this page is available at https://selflearningplatform.github.io/docs/ai-teacher.md. You can also copy the current page as Markdown by pressing Cmd+C or Ctrl+C.