All skills
lexler avatar

/socratic-learning

@7b2aaa6
by Lada Kesselerlexler/skill-factory238 stars
61

Facilitates deep, structured learning of a topic — gathering source material, assessing the learner's gaps, then teaching through guided Socratic sessions. Use when someone wants to genuinely study or be tutored on a subject over time, not get a quick answer.

Use this Skill: https://skilld.dev/gh/lexler/skill-factory/socratic-learning

This session only. Nothing lands on disk.

referenceslearning-science.md

≈506 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Learning science behind the method

Why this skill questions instead of tells — the cognitive-science mechanisms underneath. Adapted from Dr. Cat Hicks' "Learning Opportunities" (CC BY 4.0): https://github.com/DrCatHicks/learning-opportunities. Consult it when deciding how to handle a teaching moment.

The principles

  • Generation effect — people retain what they produce far better than what they read. Pull the answer out of the learner; your explanation is the fallback, not the default.
  • Pre-testing — attempting an answer before being taught makes the real answer stick, even when the attempt is wrong. Ask before you tell, every time you can.
  • Fluency illusion — a smooth explanation feels like understanding but isn't. A learner nodding along hasn't learned it; make them reconstruct it unaided.
  • Retrieval practice and spacing — recalling from memory after a gap beats re-reading. Across sessions, open by asking what they remember, not by recapping.
  • Desirable difficulty — productive struggle builds durable learning; smoothing it away feels good and teaches little. Don't rescue too early.
  • Errors as data — a wrong attempt followed by clear correction is encoded more strongly than never erring. Wrong answers are the richest moments, not failures.
  • Expertise reversal — scaffolding and worked examples help novices but slow experts. As mastery shows, drop the scaffolding and hand over harder problems.
  • Metacognition — learners who track "do I actually get this?" outlearn those who don't. Prompt them to judge their own grasp and name their gaps.

Patterns that carry across topics

  • Predict → reveal → reflect: pose a concrete scenario, get their prediction, reveal what actually happens, ask what surprised them.
  • Teach it back: "explain this as if to someone new" — gaps surface fast in their own words.
  • Retrieval check-in: at a session's start, ask what they recall before adding anything new.

These illustrate the principles; use whichever fits the moment.

Source: SKILL.md on GitHub

1 warning2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is a pedagogical framework for Socratic tutoring, designed to help users learn deeply through questioning. It uses external sources to ground its teaching. The skill is well-structured and follows safety best practices for role-play, without any detected malicious patterns such as obfuscation or exfiltration.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

Signed by skilld at 7b2aaa6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 4 months ago

README badge

README badge for lexler/skill-factory/socratic-learning