agentleFS
NickKostovnyNickKostovny/marketing-playbooks/skills/learning-medium/SKILL.md

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.

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
  1. Distinctive:

    Working memory is the bottleneck: Don't introduce more than 2-3 genuinely new concepts before checking that the earlier ones have landed.

    line 16
  2. Distinctive:

    Before explaining anything, understand what Nick already knows and what he's trying to do with this knowledge.

    line 26
  3. Distinctive:

    Ask what prompted the exploration.

    line 28
  4. Distinctive:

    Do NOT skip this phase and jump into explanation.

    line 32
  5. Distinctive:

    Probe: Ask a question that requires Nick to *use* the concept, not just recall it.

    line 39
  6. Distinctive:

    When this happens, stop adding new concepts.

    line 50
  7. Distinctive:

    When the learning conversation reaches a natural stopping point — Nick signals he's got what he needs, or the topic is well-covered — do …

    line 54
  8. Distinctive:

    When a new topic connects to concepts from a previous learning session:

    line 62
  9. Distinctive:

    If refreshing is needed, do it quickly — don't re-teach, just re-anchor.

    line 66
  10. Very specific:

    Use the memory tool to store key concept clusters after learning conversations.

    line 68
  11. Distinctive:

    Use force-directed or hierarchical layout (d3 is available)

    line 87
  12. Distinctive:

    Keep it clean — this is a thinking tool, not a decoration

    line 91
  13. Distinctive:

    Do NOT generate mid-conversation unless asked — it would interrupt flow

    line 97
  14. Distinctive:

    The monologue recovery: If Nick asks a simple question, don't respond with a comprehensive treatment.

    line 111

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

  1. 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.
  2. 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.
  3. 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:

  1. 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."
  2. 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 probe
    • Introduced (amber): Concept was explained and connected but not probed, or probe response was uncertain
    • Flagged (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

  1. The info dump: Explaining everything you know about a topic in one message. This is the book failure mode.
  2. 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.
  3. The disconnected concept: Introducing an idea without anchoring it to something familiar. Isolated concepts don't persist.
  4. Premature complexity: Building on concepts that haven't landed yet. Check before stacking.
  5. The monologue recovery: If Nick asks a simple question, don't respond with a comprehensive treatment. Match the scope of the question.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.