Skip to main content
skill CX Codex

teach-back — Claude Code skill: purpose and installation

The teach-back Claude Code skill checks understanding by asking for an explanation in the learner’s own words. It probes gaps one question at a time, then creates a cheat sheet and review questions.

MIT ★ 541 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dotslashsimran/simcraft --skill teach-back -a claude-code
Open on GitHub

What teach-back does

The skill asks for a plain-language explanation, then sorts the response into solid points, vague areas, and missing or incorrect parts. It works through the gaps in order of importance, asking one question at a time. When an answer is off, it offers brief hints before explaining the point.

After the discussion, it writes cheatsheet-<topic>.md with a summary, corrected points, a worked example, and key terms. The file ends with five review questions and answers hidden in a collapsed section. The session stops after about 8–10 questions or once the gaps are closed.

What it helps with

  • check understanding of a paper or course
  • find weak spots before an interview
  • work through confusing parts of a codebase
  • make a cheat sheet with questions for later review

Example prompts for the agent

  • Quiz me on this topic; I’ll explain it in my own words.
  • Test my understanding of this course material and ask about the gaps.
  • Help me prepare for a system design interview and make a cheat sheet.

How to install teach-back

1Skills CLI (Vercel)

npx skills add dotslashsimran/simcraft --skill teach-back -a claude-code

2Manually: put the files in place

~/.claude/skills/teach-back/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/teach-back/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about teach-back

How do I install teach-back in Claude Code?

Run npx skills add dotslashsimran/simcraft --skill teach-back -a claude-code.

What does teach-back do?

It checks understanding through a plain-language explanation and follow-up questions. Then it writes a cheat sheet with corrections and review questions.

What material can teach-back use?

It can work from a paper, notes, a document, a repository, or a video transcript. When source material is available, questions and corrections are grounded in it.

Source text

SKILL.md · MIT
---
name: teach-back
description: Find out what the user actually understands about a topic by having them explain it back (the Feynman technique), then probe the gaps one question at a time and end with a one-page cheat sheet and spaced review questions. Works for anything they are studying or have just read, watched or built: a paper, a course, a codebase, an interview topic, a concept. Use when the user says "quiz me", "test my understanding", "help me study", "I'm preparing for an interview on X", "did I get this right", or "make me a cheat sheet".
---

# Teach back

The test of understanding is explaining it simply. If the user can't explain it in plain words, there's a gap, and the gap is the part worth studying. This skill finds the gaps, fills them, and checks again later.

## 1. Set up

Ask one question at a time:
1. What's the topic, and how deep do they need it? ("Enough for a system design interview" is different from "enough to use it at work".)
2. Do they have source material? A paper, notes, a doc, a repo or a video transcript. If they do, read it, and base every question and correction on it, quoting it when you correct.

## 2. They explain, you listen

Ask them to explain the topic as if to a smart friend who's never heard of it. Voice note style is fine. Don't interrupt and don't correct yet.

Then sort what they said into three groups (show this to them briefly):
- **Solid**: correct and in their own words.
- **Fuzzy**: roughly right but vague, hand-wavy, or using jargon they didn't unpack.
- **Missing or wrong**: important parts they skipped, or got wrong.

## 3. Probe the gaps

Work through the fuzzy and missing parts, most important first, **one question at a time**:
- Ask "why" and "what would happen if" questions, not definitions. "What breaks if the cache never expires?" tests more than "What is a TTL?"
- Wait for their answer. If it's right, say so in a few words and move on. If it's wrong or stuck, give the smallest hint that gets them there, not the answer. After two hints, explain it plainly in two or three sentences, then ask them to say it back.
- Use a concrete example with real numbers whenever the topic allows.

Stop after about 8 to 10 questions or when the gaps are closed, whichever comes first. Better to end with energy left.

## 4. Cheat sheet

Write `cheatsheet-<topic>.md`, one page:
- The topic in one sentence.
- The core idea in their words (from step 2, corrected).
- The 5 to 8 things they got wrong or fuzzy, each as one line with the correct version.
- One worked example.
- Words to know, each with a plain one-line meaning.

## 5. Spaced review

Add 5 review questions at the bottom of the cheat sheet, built from their gaps, with answers in a collapsed `<details>` block. Suggest reviewing them tomorrow, in 3 days and in a week, because those spacings are when forgetting is fastest. If the user wants reminders, offer to set them up but don't do it unasked.

## Rules

- They talk more than you do. Your turns are short.
- Never mark something wrong that the source material says is right. When unsure, check the source or say you're unsure.
- No praise inflation. "Right" is enough; save "that's a great explanation" for when it is one.

© dotslashsimran · MIT · dotslashsimran/simcraft

Similar skills

SKILL.md skills catalog →

From the same set24

The whole set →
clean-audio The clean-audio Claude Code skill cleans voice audio in video, reducing hum, background noise, hiss, and harsh sibilance. It activates on audio-cleanup requests or after a rough cut. CX Codex +1 ★ 541repo stars image-gen The image-gen Claude Code skill generates and edits images from requests. It activates for illustrations, icons, thumbnails, textures, and image series that need a consistent subject. CX Codex +1 ★ 541repo stars brand-kit This Claude Code skill captures a company's visual identity from its website and saves a reusable brand kit. It runs before creating branded videos, stickers, or graphics. CX Codex +1 ★ 541repo stars next-step The next-step Claude Code skill turns a large goal or an unstructured task dump into one next action. It activates for planning requests or when someone is unsure how to begin. CX Codex +1 ★ 541repo stars from-scratch The from-scratch Claude Code skill teaches how a technology works by building a small version step by step. Before each run, the agent asks for a prediction, then checks it against the program’s output. CX Codex +1 ★ 541repo stars video-script The video-script Claude Code skill drafts short talking-head, explainer, and product-demo videos. It activates for requests to write or revise a script, hook, or YouTube, TikTok, Reels, or LinkedIn video. CX Codex +1 ★ 541repo stars repo-timelapse The repo-timelapse Claude Code skill turns a repository’s Git history into a video of the project changing over time. It runs on requests to show project growth or animate commits. CX Codex +1 ★ 541repo stars skill-router The skill-router Claude Code skill selects a matching skill or builds a sequence for a task. It kicks in when a request is vague or could call for several skills. CX Codex +1 ★ 541repo stars

Project sponsors

Companies that keep this analytics open