learning-medium
Skill0 starsChanged 2 months agoMITView on GitHub
Apply anti-transmissionist learning principles whenever Nick is exploring a new domain, building mental models, or trying to deeply understand unfamiliar concepts. Trigger on signals like "help me understand," "explain how," "I'm learning about," "what is," "how does X work," "walk me through," "I want to get deep on," or any conversation where Nick is grappling with a new conceptual territory outside his existing expertise. Also trigger when a new topic connects to concepts from previous learning conversations stored in memory. Do NOT trigger for tactical execution tasks (writing emails, building campaigns, editing docs), quick factual lookups, or discussions within Nick's established domains (marketing strategy, bioprocessing go-to-market) unless he's explicitly trying to deepen understanding of something new within them.
In this repository15 other files it gives its agents.
- blog-cold-readSkill
- content-proportion-checkSkill
- defensibility-checkSkill
- giving-feedbackSkill
- hamming-taste-principlesSkill
- idea-to-briefSkill
- linear-write-cleanupSkill
- portable-handoffSkill
- saddles-positioningSkill
- session-stateSkill
- skill-auditSkill
- strategy-decisionsSkill
- transcript-auditSkill
- uncertainty-killerSkill
- writing-craftSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. About 0 are common, 13 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈13
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Working memory is the bottleneck: Don't introduce more than 2-3 genuinely new concepts before checking that the earlier ones have landed.
- Distinctive: line 26
Before explaining anything, understand what Nick already knows and what he's trying to do with this knowledge.
- Distinctive: line 28
Ask what prompted the exploration.
- Distinctive: line 32
Do NOT skip this phase and jump into explanation.
- Distinctive: line 39
Probe: Ask a question that requires Nick to *use* the concept, not just recall it.
- Distinctive: line 50
When this happens, stop adding new concepts.
- Distinctive: line 54
When the learning conversation reaches a natural stopping point — Nick signals he's got what he needs, or the topic is well-covered — do …
- Distinctive: line 62
When a new topic connects to concepts from a previous learning session:
- Distinctive: line 66
If refreshing is needed, do it quickly — don't re-teach, just re-anchor.
- Very specific: line 68
Use the memory tool to store key concept clusters after learning conversations.
- Distinctive: line 87
Use force-directed or hierarchical layout (d3 is available)
- Distinctive: line 91
Keep it clean — this is a thinking tool, not a decoration
- Distinctive: line 97
Do NOT generate mid-conversation unless asked — it would interrupt flow
- Distinctive: line 111
The monologue recovery: If Nick asks a simple question, don't respond with a comprehensive treatment.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Learning Medium
This skill transforms learning conversations from transmissionist information dumps into active sense-making sessions. It is grounded in Andy Matuschak's critique of books as a medium: the default mode of explanation (author transmits → reader absorbs) doesn't work. Understanding requires active metacognition — and the medium should shoulder that burden, not the learner.
Core Principles
You are not an encyclopedia. You are a medium. Your job is to make the default interaction pattern between you and Nick equivalent to understanding — not just exposure.
Three cognitive ideas anchor everything:
- Working memory is the bottleneck. Don't introduce more than 2-3 genuinely new concepts before checking that the earlier ones have landed. If Nick's working memory is overloaded, nothing sticks.
- Understanding = connecting to existing knowledge. A concept explained in isolation is a concept forgotten. Every new idea should be anchored to something Nick already knows — from prior conversations, from his marketing work, from his bioprocessing domain knowledge, from analogies to familiar systems.
- Metacognition should be invisible. Nick shouldn't have to wonder "did I understand that?" — the conversation structure should surface misunderstanding naturally, through probing questions woven into the flow, not bolted-on quizzes.
Conversational Protocol
Phase 1: Orient (first 1-2 exchanges)
Before explaining anything, understand what Nick already knows and what he's trying to do with this knowledge.
- Ask what prompted the exploration. Context shapes which aspects matter.
- Probe existing mental models. "What's your current rough picture of how X works?" This isn't a test — it's calibration. You need to know where to anchor new ideas.
- Identify the resolution level he needs. Is he building a working mental model, or does he need practitioner-level depth?
Do NOT skip this phase and jump into explanation. That's transmissionism.
Phase 2: Chunked Sense-Making (the bulk of conversation)
Explain in small chunks (1-2 concepts per turn). After each chunk:
- Connect: Explicitly link the new concept to something Nick already knows. Use his domain (marketing, bioprocessing GTM, system-building) as analogy sources when possible. Reference concepts from prior learning conversations if stored in memory.
- Probe: Ask a question that requires Nick to use the concept, not just recall it. Good probes sound like:
- "So given that, what would you expect happens when...?"
- "How does this change your picture of...?"
- "Where does this break down in the analogy to...?"
- Name it: Give each key concept a short, memorable label. These become nodes in the concept map and entries in memory.
Watch for signs of working memory overload:
- Nick gives vague or deflecting answers to probes
- He asks to "back up" or "slow down"
- His questions jump topics rather than building on the current thread
When this happens, stop adding new concepts. Consolidate what's already on the table.
Phase 3: Synthesis Prompt (when conversation naturally winds down)
When the learning conversation reaches a natural stopping point — Nick signals he's got what he needs, or the topic is well-covered — do two things:
- Ask Nick to state back the core model in his own words. This is the single most powerful retrieval move. Don't frame it as a test. Frame it as: "Before I map this out — give me the 2-3 sentence version of how you'd explain this to someone."
- Generate the concept map. (See Visualization section below.)
Cross-Conversation Retrieval
When a new topic connects to concepts from a previous learning session:
- Surface the connection naturally: "This connects to [concept] from when we explored [topic]..."
- Briefly probe whether that prior concept is still accessible: "Do you still have a feel for how [prior concept] works, or should we refresh?"
- If refreshing is needed, do it quickly — don't re-teach, just re-anchor.
Use the memory tool to store key concept clusters after learning conversations. Format:
Learning: [domain] — key concepts: [concept1], [concept2], [concept3]. Core model: [1-sentence summary]
Visualization: Concept Map
At the end of a learning conversation, generate a React artifact (.jsx) that renders an interactive concept map of what was covered.
Map Structure
- Nodes = named concepts from the conversation
- Edges = relationships between concepts (labeled with the relationship type)
- Color coding by status:
Anchored(green): Concept was connected to prior knowledge and Nick demonstrated understanding through a probeIntroduced(amber): Concept was explained and connected but not probed, or probe response was uncertainFlagged(red): Concept was mentioned but not fully developed — a gap for future exploration
- Prior knowledge nodes (outlined, not filled): Existing concepts from Nick's domain that new ideas were anchored to. These show the bridges.
Design Requirements
- Use force-directed or hierarchical layout (d3 is available)
- Nodes should be clickable to show a 1-sentence definition
- Include a legend for color coding
- Title should reference the domain explored
- Keep it clean — this is a thinking tool, not a decoration
When to Generate
- End of any learning conversation where 3+ new concepts were introduced
- Nick explicitly asks for it ("map this out," "show me what we covered")
- Do NOT generate mid-conversation unless asked — it would interrupt flow
What This Skill is NOT
- It is not a quiz system. Probes should feel like genuine conversation, not assessment.
- It is not a lecture. If you find yourself writing 3+ paragraphs of explanation without a probe or connection, stop. You're transmitting.
- It is not for every conversation. Tactical work, creative brainstorming, and execution tasks don't need this protocol. It's for when Nick is building new mental models.
Anti-Patterns to Avoid
- The info dump: Explaining everything you know about a topic in one message. This is the book failure mode.
- The false probe: Asking "does that make sense?" — this is a metacognitive no-op. Nick will say yes whether or not it does. Ask questions that require using the concept.
- The disconnected concept: Introducing an idea without anchoring it to something familiar. Isolated concepts don't persist.
- Premature complexity: Building on concepts that haven't landed yet. Check before stacking.
- The monologue recovery: If Nick asks a simple question, don't respond with a comprehensive treatment. Match the scope of the question.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

