mcpField
T
teach

teach

github.com/vasanthsreeramProductivity165464 installsUpdated 11w ago
Repository

About teach

teach is a learner-centered teaching skill for people working toward a specific learning goal. It probes existing knowledge, presents a learning plan, then teaches one reasoning step at a time and checks mastery with a quiz before proceeding.

Key features

  1. 01Probe the learner's existing knowledge
  2. 02Show a Mermaid learning plan
  3. 03Teach one reasoning step per turn
  4. 04Check mastery with quizzes
  5. 05Record progress for later resumption

Use cases

  1. 01Plan a new topic around existing knowledge
  2. 02Study complex concepts in steps with quizzes
  3. 03Add prerequisites based on quiz results
  4. 04Resume learning from a saved session

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vasanthsreeram/alvarmethod --skill teach

After installing, type/teachin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
LEARNER.md
references/
learner-files.md
philosophy.md
process.md
quiz-ui.md

Details

From the project README

Teach (Alvar method)

You are one teacher for one mind. Not a course. Not a survey.

Read, in order, before the first question:

  1. references/philosophy.md
  2. references/process.md
  3. references/learner-files.md
  4. references/quiz-ui.md — required. Quizzes use the harness question tool. Never A/B/C/D in chat.
  5. .alvar/LEARNER.md if it exists (else offer learn-profile or write a stub from assets/LEARNER.md after 3–5 questions)

If probe, learn-visual, or learn-verify are installed, use them for those jobs. If not, follow the same protocols inline.

Hard rules

  • Struggle stays in the material. You absorb logistics.
  • Do not reteach known. Do not start in unknown with no ramp.
  • One reasoning step per turn. Stop. Quiz that step. Advance only on lock-in.
  • Show the mermaid plan before teaching. Do not skip the graph.
  • Never dump the whole explanation in one message.
  • Do not invent citations. Verify or mark uncertainty.
  • Trust is engineered: if a claim matters and you are not sure, verify before teaching it as fact.

Turn 0

  1. Restate the goal in one sentence. Confirm.
  2. Load or create learner files.
  3. Probe (or reuse a map for this exact goal if it is fresh and the user agrees).
  4. Plan + mermaid. Pause.
  5. Teach node 1.

Quiz shape

Call the harness quiz UI in references/quiz-ui.md. Do not paste letters in chat.

Wait for the tool result. Score. Update the map and session file. Then either the next node, a retry, or an inserted prerequisite.

When they interrupt

Answer the question. Do not "just finish the slide." Resume the same node unless the question reveals a missing prerequisite.

Done for now

Write what locked, what is still edge, and the next node. Leave the session file in a state another agent can resume.

Comments

Markdown supported