vault-teach

Teaches topics through Socratic probing and grounded explanations, logging lessons into an Obsidian vault.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/salomepoulain/makery-stations --skill vault-teach-salomepoulain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-teach
Source: https://github.com/salomepoulain/makery-stations/tree/main/stations/claude/workbench/pantry/skills/vault-teach
Command: npx skills add https://github.com/salomepoulain/makery-stations --skill vault-teach-salomepoulain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Explaining a topic once rarely makes it stick; facts get memorized, then forgotten. This Skill turns any explanation into a structured teaching session that builds genuine understanding by connecting new facts to foundations the learner already accepts, and it grounds every claim in the project's .vault/ knowledge base before falling back to the web. ## Core Features & Use Cases - Probe-Plan-Teach workflow: Maps the learner's current level with graded quiz questions, presents a dependency-graph lesson plan as a mermaid diagram for approval, then teaches node by node with quiz-checks after each concept. - Vault-first grounding: Dispatches a read-only research agent that searches the vault's summaries, maps, and raw sources before using web search, so lessons build on material already collected. - Durable trace: Writes a lesson transcript to wiki/lessons/ and updates a mastery map in wiki/maps/ tracking which strands are solid, fuzzy, or missing. - Use Case: A student asks to finally understand eigenvalues before an exam. The Skill probes their linear algebra foundations, finds past exams in the vault to calibrate against, teaches via motivated discovery steps, and leaves a lesson log plus an updated mastery map for future sessions. ## Quick Start Ask the assistant to teach you a topic, for example: teach me how Bayesian updating works using my vault, starting from what I already know.

Frequently Asked Questions about vault-teach

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I teach a topic so it is actually understood?

Use a probe-plan-teach loop: first map the learner's current level with graded questions, then present a dependency-graph plan rooted in unconditional truths, then teach one node at a time with a quiz-check after each. This Skill automates that entire workflow.

How does the skill use my Obsidian vault for teaching?

It reads the vault's schema file first, then dispatches a read-only agent that greps wiki summaries, maps, and raw source stubs for existing coverage before falling back to web search. Lessons and mastery maps are written back into wiki/lessons/ and wiki/maps/.

What happens if there is no .vault directory in my project?

The Skill stops and tells you no vault exists rather than guessing a structure or teaching ungrounded. Creating a vault is handled by a separate vault scaffolding skill, after which this teaching skill can proceed.

Can it prepare me for a specific exam or course?

Yes. If the vault contains past exams or homework, the Skill reads them to extract tested topics, question styles, and common traps, then calibrates probing questions and the lesson plan against that real assessment bar instead of a generic one.

Does the grounding agent modify my vault files?

No. The research dispatch is strictly read-only and explicitly forbidden from writing, moving, or deleting anything in the vault. Web findings worth keeping are reported as gaps for a separate deliberate inbox pass.