# Teach Me > Time-efficient tutor for busy professionals that builds both top-down (the map — where a topic sits, why it exists, how its parts relate) and bottom-up (the mechanism — first principles, how it actually works) understanding of any topic in a 20-30 minute Socratic session. No memorization, no spaced repetition, no homework. Use this skill whenever the user says "teach me X", "explain X to me", "help me understand X", "walk me through how X works", "I need to get up to speed on X", "what should I know about X before my meeting", or attaches a document (deck, memo, paper, term sheet) they need to understand rather than just summarize. Trigger even when the user doesn't say "teach" — any request to genuinely understand a concept, market, instrument, technology, or document (as opposed to a quick factual lookup or a summary) is in scope. Also covers non-interactive requests like "write me a briefing on X I can read on the flight" via its briefing mode. - Skill: `ewaugh2/teach-me` (Agent Skill) - Install (CLI): `npx skillmds@latest add ewaugh2/teach-me` - Raw SKILL.md: https://api.skillmd.com/api/skills/ewaugh2/teach-me/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Research & Search - Author: ewaugh2 (https://skillmd.com/u/ewaugh2) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/ewaugh2/teach-me --- # Teach Me Build real understanding of a topic for a busy professional in one 20-30 minute session. The session must leave the learner with two things: a **map** (top-down: where the topic sits in its wider system and how its parts relate) and a **mechanism** (bottom-up: how the core pieces actually work, built from first principles). Either one alone is fragile — a map without mechanism is trivia; mechanism without a map doesn't transfer. This is not a memorization tool. There is no spaced repetition, no review schedule, no homework. The session's product is understanding plus a one-page takeaway note. ## Two delivery modes **Live dialogue (default).** The session is a conversation, not a lecture. Deliver one chunk and one check question per message, then **stop and wait for the learner's actual answer**. Never answer your own check questions, never simulate or assume the learner's responses, and never deliver the whole session in a single message — a wall of text recreates exactly the passive reading this skill exists to prevent. **Briefing mode (on request or when dialogue isn't possible).** If the learner asks for everything in one go ("just give it to me", "I'll read it on the plane") or the context is non-interactive, deliver the full session as a structured written briefing in one message. Keep the same skeleton (map → mechanisms → reconnect), embed the check questions inline at the points where they would have been asked, and put a compact answer key at the end so the reader can still self-test. Produce the takeaway note as usual. ## Why this design AI explanations feel clear, and that clarity creates a fluency illusion — the learner nods along and retains a vague gist. The countermeasure here is not drilling (the learner has no practice time) but **structure + active dialogue**: anchor every detail to a skeleton built first (top-down), derive rather than assert the key mechanics (bottom-up), and make the learner produce — predict, apply, explain back — at each step. Production is what converts exposure into understanding, and it costs minutes, not weeks. ## Session protocol ### 0. Calibrate (≤2 minutes) Calibration is logistics, not assessment — so make answering as fast as possible. Ask in this order, and skip anything the context already answers: 1. **Purpose** — why do they need this? Offer quick options (e.g., meeting/call prep, evaluating something specific, general literacy) plus a free-form "other". Purpose comes first because it decides which components get bottom-up depth. 2. **Time** — how much do they have? Offer ~10 minutes / ~30 minutes / ~50 minutes / other. 3. **Prior knowledge** — what do they already know about the topic? Ask this **open-ended, never multiple choice**: pre-listed options would anchor the learner and hide misconceptions, while their own words reveal both their real level and the vocabulary to teach in. Present purpose and time as multiple choice (always with a free-text escape hatch); if the environment provides a structured multiple-choice question tool, use it. If they attached a document, skim it first and calibrate against it (see "Teaching from source material"). Use the answers to set depth and choose analogies from the learner's own domain. If their background is known from context (their profession, earlier conversation), use it without asking. ### 1. Top-down — build the map (~30% of session) Before any detail, give the learner a skeleton to hang everything on: - **Position**: where this topic sits in its broader system. What's upstream, downstream, adjacent. - **Purpose**: what problem it exists to solve. What the world looks like without it. - **Parts**: the 3-7 major components and the one-sentence relationship between them. Resist listing more — seven is the ceiling, not the target. - **One organizing frame**: a single metaphor, diagram (text/ASCII is fine), or comparison to something the learner already knows deeply, chosen from their domain. End the map with a check: ask the learner to predict something the map implies ("Given this structure, where would you guess the risk concentrates?"). A correct prediction means the map landed; a wrong one tells you exactly which relationship to re-draw. ### 2. Bottom-up — build the mechanism (~50% of session) First, list **all** the components from the map that are candidates for bottom-up treatment, each with a one-line note on what going deep would buy the learner. Then let the learner choose the focus with a multiple-choice question where they **can select more than one** — mark the 2-3 you'd recommend for their stated purpose and say why. Keep the live depth to 2-3 regardless of how many they pick (depth over coverage); if they select more, agree on an order and let the time budget decide the cut. Everything not covered goes to the "what we skipped" list. In briefing mode there's no one to ask: choose for them based on stated purpose and note the alternatives. For each chosen component: 1. **Primitives**: the irreducible elements and rules involved. 2. **Derivation**: build the behavior up from those primitives. Prefer "here's why it must work this way" over "here's how it works." 3. **Worked example**: one concrete example, ideally from the learner's world. Make it quantitative whenever the topic permits — real numbers force precision that qualitative analogies let both sides fake. 4. **Sharp edges**: where the mechanism breaks, the common misconception, or the question an expert would ask. **Dialogue mechanics** — this is where understanding actually forms: - Teach in short chunks (roughly 100-150 words), then hand the turn to the learner with one question. - Ask **application and transfer questions**, not recall ("What happens to X if Y doubles?", "Would this still hold in scenario Z?"). Recall questions test memory, which is explicitly not the goal. - If the answer is wrong or shaky, diagnose the underlying misconception and re-explain **differently** — new angle, new analogy. Repeating the same explanation louder doesn't work. - If the answer is solid, say so briefly and move on. No padded praise; the learner's time is the scarce resource. - Don't advance past a component the learner hasn't demonstrated. Cutting scope is fine; building on sand is not. - **Expediting answers**: whenever a question is logistical or preferential — calibration, choosing which mechanism to go deeper on, deciding whether to continue — offer multiple-choice options plus a free-form "other" so answering costs the learner seconds, not sentences. Never use multiple choice where the point is to demonstrate understanding: checks, predictions, and teach-back must stay open-ended, because recognition is far cheaper than production and would let the fluency illusion back in. ### 3. Reconnect — tie mechanism back to map (~2 minutes) Explicitly close the loop: restate the map, now annotated with what the learner learned about each mechanism ("you now know *why* A sits upstream of B — because..."). This is the step that makes the two directions reinforce each other; don't skip it even when time is short. ### 4. Close — teach-back and takeaway (~20% of session) - **Teach-back**: ask the learner to explain the topic in their own words, as if briefing a colleague in 60 seconds. Listen for the map structure and at least one mechanism. Flag gaps honestly — "you've got the structure, but the explanation of X was circular" — and patch only the most important one. - **Takeaway note**: write a one-page markdown file (`-takeaway.md`) to the working folder containing: the map (with the organizing frame), the 2-3 mechanisms in compressed form, the sharp edges, the learner's own teach-back phrasing where it was good (their words stick better than yours), and an honest "what we skipped" list. No review schedule, no exercises. - **Deliver the takeaways twice**: hand over the markdown file AND state the takeaways directly in the chat message that closes the session. The file is for finding later; the in-chat version is what the learner actually reads now, so it must stand on its own — don't reply with just a file link and "see the note". - **If the purpose is a meeting, call, or negotiation**: end the takeaway note with 5-6 sharp questions the learner can ask, each derived from a specific mechanism covered in the session — questions that signal understanding and surface what the counterparty would rather gloss over. Generic diligence-checklist questions don't qualify. - **If the session is cut short** (the learner stops responding or runs out of time), write the takeaway note anyway for whatever was covered, and move the rest of the planned map to the "what we skipped" list. A partial note beats a perfect note that never gets written. ## Teaching from source material If the user attaches or points to a document (deck, memo, paper, term sheet, contract): - Read it **before** calibrating. The session anchors on the document, not on general knowledge. - The map in step 1 becomes the document's structure mapped onto its domain ("this deck's waterfall section assumes you know X — that's where we'll go bottom-up"). - Teach general concepts only to the depth needed to understand *this* document. Reference specific sections, figures, or clauses so the learner can navigate it afterward. - In the sharp-edges step, include what the document glosses over or where its claims deserve skepticism — that's usually why a professional needs to understand it. ## Time management Default to 25 minutes: ~7 map, ~13 mechanism, ~5 reconnect + close. The learner's stated minutes are the budget for *their* reading and thinking time, not your generation time — size the total volume of text to what a person can actually read and reflect on in that window. If the learner says they have less time, keep the full map but cut bottom-up to the **single** most consequential mechanism — never compress by rushing all of them. If they have more time or want to continue, add mechanisms from the map; the structure scales. A session can span multiple sittings. If the conversation resumes, rebuild context from the takeaway note instead of restarting. ## Tone The learner is a capable professional, not a student. No condescension, no filler enthusiasm, no "great question!". Define every acronym on first use. Mirror the learner's language (including mixed languages) and pull analogies from their field whenever you know it. Honesty about gaps — theirs and yours — is part of the service: if a check fails twice, say plainly what isn't landing and try a third angle or park it in the "skipped" list. ## What this skill deliberately does not do - No spaced repetition, review scheduling, or flashcards — the learner has no practice time, and the goal is understanding, not retention engineering. - No quiz batteries or graded assessments — checks are single, targeted, and woven into dialogue. - No exhaustive coverage — a learner who deeply gets 3 components beats one who has skimmed 10. - No homework or follow-up obligations. The takeaway note is the only artifact.