Socratic Teaching Scaffolds

Guides learners to discover knowledge through strategic Socratic questioning and progressive scaffolding removal. Combines question ladders, misconception detectors, Feynman explanations, and worked-example fading to build durable understanding. Use when teaching complex concepts, correcting misconceptions, onboarding team members, mentoring problem-solving, or designing self-paced learning. Use when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".

200 stars 25 forksLearning & Education Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add lyndonkl/claude

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add lyndonkl/claude --skill socratic-teaching-scaffolds
Manual install
git clone --depth 1 https://github.com/lyndonkl/claude.git /tmp/claude
mkdir -p ~/.claude/skills
cp -r /tmp/claude/skills/socratic-teaching-scaffolds ~/.claude/skills/socratic-teaching-scaffolds

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Socratic Teaching Scaffolds

## Table of Contents
1. [Workflow](#workflow)
2. [Socratic Question Types](#socratic-question-types)
3. [Scaffolding Levels](#scaffolding-levels)
4. [Common Patterns](#common-patterns)
5. [Guardrails](#guardrails)
6. [Quick Reference](#quick-reference)

**Core components:**
1. **Question Ladders**: Sequences from simple to complex that build understanding incrementally
2. **Misconception Detectors**: Questions that reveal faulty mental models through contradiction
3. **Feynman Explanations**: Build-up from simple analogies to technical precision
4. **Worked Examples with Fading**: Full solutions → partial solutions → independent practice
5. **Cognitive Apprenticeship**: Model thinking process explicitly, then transfer to learner

**Quick example (Teaching Recursion):**

**Question Ladder:**
1. "Can you break this problem into a smaller version of itself?" (problem decomposition)
2. "What would happen if we had only one item?" (base case discovery)
3. "If we could solve the small version, how would we use it for the big version?" (recursive case)
4. "What prevents this from running forever?" (termination reasoning)

**Misconception Detector:**
- "Will this recursion ever stop? Trace it with 3 items." (reveals infinite recursion misunderstanding)

**Feynman Progression:**
- Level 1: "Like Russian nesting dolls--each contains a smaller version"
- Level 2: "Function calls itself with simpler input until base case"
Read the full skill on GitHub

Details

Skill name
socratic-teaching-scaffolds
Path
skills/socratic-teaching-scaffolds/SKILL.md
Repo updated
1 September 2026

FAQ

What does the Socratic Teaching Scaffolds skill do?

Guides learners to discover knowledge through strategic Socratic questioning and progressive scaffolding removal. Combines question ladders, misconception detectors, Feynman explanations, and worked-example fading to build durable understanding. Use when teaching complex concepts, correcting misconceptions, onboarding team members, mentoring problem-solving, or designing self-paced learning. Use when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".

How do I install the Socratic Teaching Scaffolds skill?

Claude Code plugin: /plugin marketplace add lyndonkl/claude. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Socratic Teaching Scaffolds popular?

It lives in lyndonkl/claude, which has 200 GitHub stars and 25 forks.

Related skills

Abstraction Concrete Examples

200

lyndonkl/claude

Builds structured abstraction ladders that translate high-level principles into concrete, actionable examples across 3-5 levels. Bridges communication gaps, reveals hidden assumptions, and tests whether abstract ideas work in practice. Use when explaining concepts at different expertise levels, moving between abstract principles and concrete implementation, identifying edge cases by testing ideas against scenarios, designing layered documentation, decomposing complex problems into actionable steps, or bridging strategy-execution gaps.

Testing & QA25

Academic Letter Architect

200

lyndonkl/claude

Guides the creation of evidence-based academic recommendation letters, reference letters, and award nominations that combine concrete examples, meaningful comparisons, and genuine enthusiasm. Use when writing recommendation letters for students, postdocs, or colleagues, or when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy and comparative statements.

Research & Science25

Adr Architecture

200

lyndonkl/claude

Documents significant architectural and technical decisions with full context, alternatives considered, trade-offs analyzed, and consequences understood. Creates a decision trail that helps teams understand why decisions were made. Use when choosing between technology options, making infrastructure decisions, establishing standards, migrating systems, or when user mentions ADR, architecture decision, technical decision record, or decision documentation.

Software Development25

Teach

100

adriannoes/awesome-agentic-ai

Explain a body of work plainly so a person actually understands it. Runs the `how` and `why` skills and weaves what they find into one clear explanation. Use for 'teach me this', 'help me really understand X', 'explain this change or subsystem to me'.

Learning & EducationIn 2 lists27

Principle Never Block on the Human

100

adriannoes/awesome-agentic-ai

Apply when tempted to ask 'should I do X?' on reversible work. Proceed, present the result, let the human course-correct after the fact; reserve confirmation for irreversible actions.

Learning & EducationIn 2 lists27

Wc Decision Logger

200

lyndonkl/claude

Appends FIFA World Cup Fantasy decisions to tracker/decisions-log.md — logging not just what the manager chose but the full OPTION SET they chose from, which option the board recommended, whether the manager overrode it, and the manager's stated reasoning. Also archives the full generation (population → offspring → board → pick) to generations/, and updates the archetype scoreboard (which genotypes' blocks were chosen/won) and the manager's revealed preferences. Append-only; never overwrites. The override rows are the system's most valuable learning signal. Use after the manager picks an optio

Learning & Education25

Browse the most popular Claude skills, all learning & education skills, or write your own with the skills generator.